This page shows you how to set a monthly spend alert and monitor your organization’s usage.

​
Set a monthly spend alert

To receive an email notification when your organization’s spending reaches a specified limit, set a monthly spend alert:
  1. Go to Settings > Usage in the Pinecone console.
  2. In the Monthly spend alert section, click Create spend alert.
  3. Enter the dollar amount at which you want to receive an alert.
  4. Click Update alert.

​
Monitor organization-level usage

You must be the organization owner to view usage across your Pinecone organization. Also, this feature is available only to organizations on the Standard or Enterprise plans.
To view and download a report of your usage and costs for your Pinecone organization, go to Settings > Usage in the Pinecone console. All dates are given in UTC to match billing invoices.

​
Monitor token usage

Requests to the chat, context retrieval, and evaluation API endpoints return a usage parameter with prompt_tokens, completion_tokens, and total_tokens generated.
For chat, tokens are defined as follows:
  • prompt_tokens are based on the messages sent to the assistant and the context snippets retrieved from the assistant and sent to a model. Messages sent to the assistant can include messages from the chat history in addition to the newest message. prompt_tokens appear as Assistants Input Tokens on invoices.
  • completion_tokens are based on the answer from the model. completion_tokens appear as Assistants Output Tokens on invoices.
  • total_tokens is the sum of prompt_tokens and completion_tokens.
Example chat response
{
    "finish_reason": "stop",
    "message": {
        "role": "assistant",
        "content": "The Chief Financial Officer (CFO) of Netflix is Spencer Neumann."
    },
    "id": "000000000000000030513193ccc52814",
    "model": "gpt-4o-2024-11-20",
    "usage": {
        "prompt_tokens": 23626,
        "completion_tokens": 21,
        "total_tokens": 23647
    },
    "citations": [
        {
            "position": 63,
            "references": [
                {
                    "file": {
                        "status": "Available",
                        "id": "99305805-3844-41b5-af56-ee693ab80527",
                        "name": "Netflix-10-K-01262024.pdf",
                        "size": 1073470,
                        "metadata": null,
                        "updated_on": "2025-07-29T20:07:53.171752661Z",
                        "created_on": "2025-07-29T20:07:36.361322699Z",
                        "percent_done": 1,
                        "signed_url": "https://storage.googleapis.com/...",
                        "error_message": null
                    },
                    "pages": [
                        78,
                        79,
                        80
                    ],
                    "highlight": null
                },
                {
                    "file": {
                        "status": "Available",
                        "id": "99305805-3844-41b5-af56-ee693ab80527",
                        "name": "Netflix-10-K-01262024.pdf",
                        "size": 1073470,
                        "metadata": null,
                        "updated_on": "2025-07-29T20:07:53.171752661Z",
                        "created_on": "2025-07-29T20:07:36.361322699Z",
                        "percent_done": 1,
                        "signed_url": "https://storage.googleapis.com/...",
                        "error_message": null
                    },
                    "pages": [
                        77,
                        78
                    ],
                    "highlight": null
                }
            ]
        }
    ]
}