Skip to main content

How do I check my token usage?

Check your token usage for your API calls

Updated over 3 weeks ago

As of March 11, 2025, we’ve released the building blocks of our new Agents platform. For details, see our API docs for our Responses API, Tools including Web Search, File Search, and Computer Use, and our Agents SDK with Tracing.

There are two main options for checking your token usage:

The usage dashboard displays your API usage during the current and past monthly billing cycles. To display the usage of a particular user of your organizational account, you can use the dropdown next to "Daily usage breakdown".

2. Usage data from the API response

You can also access token usage data through the API. Token usage information is included in responses from our endpoints under the usage key.

Here's an example:

{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1677858242,
"model": "gpt-3.5-turbo",
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
},
"choices": [
{
"message": {
"role": "assistant",
"content": "This is a test!"
}
}
]
}

If you're using streaming for our completions and would like to access usage data, ensure that your stream_options parameter contains the following:

stream_options: {"include_usage": true}. Here's our cookbook for How to stream completions and our platform documentation on streaming.

Did this answer your question?