OpenAI

OpenAI Usage API

The Usage API from OpenAI — 9 operation(s) for usage.

GitHub OpenAPI
Business capability
Usage Metering BC-4250.10

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organization/costs Report the organization's spend over time · Costs #
Ask an LLM
“How much has my organization spent on the API since the start of the month?”
“Can I break my costs down by project or line item?”
Tell an agent
Show our API costs since {start_time}.
Break down costs from {start_time} to {end_time} grouped by {group_by}.
GET /organization/usage/audio_speeches Report text-to-speech usage · Audio speeches #
Ask an LLM
“How many characters of text-to-speech did we generate this month?”
“Which models are driving our speech generation usage?”
Tell an agent
Show text-to-speech usage since {start_time}.
Break down audio speech usage since {start_time} by {group_by}.
GET /organization/usage/audio_transcriptions Report speech-to-text transcription usage · Audio transcriptions #
Ask an LLM
“How many seconds of audio have we transcribed recently?”
“Can I see transcription usage for just one API key?”
Tell an agent
Show audio transcription usage since {start_time}.
Show transcription usage for API keys {api_key_ids} since {start_time}.
GET /organization/usage/code_interpreter_sessions Report code interpreter session usage · Code interpreter sessions #
Ask an LLM
“How many code interpreter sessions has our organization opened?”
“Which projects are using the most code interpreter sessions?”
Tell an agent
Show code interpreter session counts since {start_time}.
Count code interpreter sessions for projects {project_ids} since {start_time}.
GET /organization/usage/completions Report token usage for completions · Completions #
Ask an LLM
“How many input and output tokens did we use on chat and completions this week?”
“Can I separate batch token usage from regular requests?”
Tell an agent
Show completions token usage since {start_time}.
Show completion tokens for models {models} since {start_time} in {bucket_width} buckets.
GET /organization/usage/embeddings Report embeddings usage · Embeddings #
Ask an LLM
“How many tokens have we sent to embedding models lately?”
“Can I see embedding usage broken down per user?”
Tell an agent
Show embeddings usage since {start_time}.
Show embedding tokens for users {user_ids} since {start_time}.
GET /organization/usage/file_search_calls File search calls #
GET /organization/usage/images Report image generation usage · Images #
Ask an LLM
“How many images did we generate or edit this month?”
“Can I filter image usage by image size or by whether it was a generation or an edit?”
Tell an agent
Show image usage since {start_time}.
Show {sizes} image usage from {sources} since {start_time}.
GET /organization/usage/moderations Report moderation usage · Moderations #
Ask an LLM
“How much have we used the moderation endpoint recently?”
“Which projects send the most content through moderation checks?”
Tell an agent
Show moderation usage since {start_time}.
Group moderation usage since {start_time} by {group_by}.
GET /organization/usage/vector_stores Report vector store storage usage · Vector stores #
Ask an LLM
“How many bytes are we storing across our vector stores?”
“Can I track vector store storage per project over time?”
Tell an agent
Show vector store usage since {start_time}.
Show vector store storage for projects {project_ids} since {start_time}.
GET /organization/usage/web_search_calls Web search calls #

Documentation

📖
Documentation
https://platform.openai.com/docs/assistants/overview
📖
Documentation
https://platform.openai.com/docs/api-reference/assistants
📖
Documentation
https://platform.openai.com/docs/guides/text-to-speech
📖
Documentation
https://platform.openai.com/docs/api-reference/audio
📖
Documentation
https://platform.openai.com/docs/guides/speech-to-text
📖
Documentation
https://developers.openai.com/api/docs/guides/audio/
📖
Documentation
https://developers.openai.com/api/docs/guides/voice-agents/
📖
Documentation
https://platform.openai.com/docs/api-reference/chat
📖
Documentation
https://platform.openai.com/docs/guides/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/files
📖
Documentation
https://platform.openai.com/docs/guides/fine-tuning
📖
Documentation
https://platform.openai.com/docs/api-reference/fine-tuning
📖
Documentation
https://platform.openai.com/docs/guides/images
📖
Documentation
https://platform.openai.com/docs/api-reference/images
📖
Documentation
https://platform.openai.com/docs/guides/image-generation
📖
Documentation
https://platform.openai.com/docs/guides/images-vision
📖
Documentation
https://platform.openai.com/docs/models
📖
Documentation
https://platform.openai.com/docs/api-reference/models
📖
Documentation
https://platform.openai.com/docs/assistants/how-it-works/managing-threads-and-messages
📖
Documentation
https://platform.openai.com/docs/api-reference/threads
📖
Documentation
https://platform.openai.com/docs/api-reference/completions

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-usage-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-chat-completion-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-embedding-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-ld/openai-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/openai:openai-usage-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openai-usage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAI Usage API
  description: The OpenAI REST API. Please see https://platform.openai.com/docs/api-reference for more details.
  version: 2.3.0
  termsOfService: https://openai.com/policies/terms-of-use
  contact:
    name: OpenAI Support
    url: https://help.openai.com/
  license:
    name: MIT
    identifier: MIT
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-usage-api-openapi.yml