Use the view credit usage stats endpoint to monitor your team's credit balance across every credit type in the current billing cycle.
For each credit type, the response returns the `limit` (your team's allowance for the cycle), `consumed` (credits used so far), and `left_over` (credits remaining). The `current_credit_cycle` object reports the start and end dates of the billing cycle these stats cover.
Balances reflect your team's running credit usage and update within seconds of a credit-consuming request. To retrieve credit usage for a single user instead of the whole team, use get current user profile with the `include_credit_usage` query parameter set to `true`.
### Credit types
The `credit_usage_stats` object is keyed by credit type. Each key funds a different Apollo action:
| Key | What it funds |
| -------------------------------- | ------------------------------------------------------------ |
| `lead_credit` | Email address reveals and email enrichment. |
| `direct_dial_credit` | Mobile and direct dial phone number reveals. |
| `export_credit` | CSV exports of contacts and accounts. |
| `conversation_credit` | Conversation intelligence and call recording. |
| `ai_credit` | AI-generated email writing. |
| `power_up_credit` | AI power-up field enrichment on contact and account records. |
| `inbound_website_visitor_credit` | Inbound website visitor identification. |
| `contact_website_visitor_credit` | Contact-level website visit tracking. |
| `web_search_record_credit` | Web search enrichment records. |
| `dialer` | Dialer talk time. Reported in **minutes**, not credits. |
A credit type your Apollo plan doesn't include returns a `limit` of `0`.
If your team is on a unified credit plan, `lead_credit` is a shared pool: the `left_over` value already accounts for mobile reveals, exports, dialer minutes, and power-up enrichment, so don't add the individual balances together to estimate what's left.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "apollo-rest-api",
"summary": "Programmatic access to Apollo's sales intelligence and engagement platform — data enrichment, prospect and company search, and go-to-market workflow management.",
"description": "The Apollo API provides programmatic access to [Apollo](https://www.apollo.io/), the all-in-one sales intelligence and engagement platform. Use it to enrich people and company data (individually or in bulk), search Apollo's database of over 240 million contacts and 30 million companies, and manage accounts, contacts, deals, sequences, tasks, calls, and conversations in your go-to-market workflows.\n\n## Base URL\n\nAll API requests are made to `https://api.apollo.io/api/v1`.\n\n## Authentication\n\n- **Apollo users** authenticate with an API key passed in the `x-api-key` request header. See [Create API Keys](https://docs.apollo.io/docs/create-api-key).\n- **Apollo partners** building integrations on behalf of mutual users authenticate with the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners).\n\n## Rate limits & credits\n\nRate limits and credit consumption depend on your [Apollo pricing plan](https://docs.apollo.io/docs/api-pricing). Check your current limits and usage with the [view API usage stats and rate limits](https://docs.apollo.io/reference/view-api-usage-stats) endpoint. For more details, see [Rate Limits](https://docs.apollo.io/reference/rate-limits) and the [API FAQs](https://docs.apollo.io/docs/apollo-api-faqs).\n\nNew to the API? Start with the [Apollo API overview](https://docs.apollo.io/reference/apollo-api).",
"termsOfService": "https://www.apollo.io/terms/api",
"contact": {
"name": "Apollo API Support",
"url": "https://docs.apollo.io/"
},
"version": "1.0"
},
"servers": [
{
"url": "https://api.apollo.io/api/v1"
}
],
"tags": [
{
"name": "Miscellaneous",
"description": "Users, email accounts, lists, notes, usage stats, and webhook results."
}
],
"components": {
"securitySchemes": {
"apiKey": {
"type": "apiKey",
"in": "header",
"name": "x-api-key",
"description": "[Recommended] API key, passed in the `x-api-key` request header.\nSee [Create API Keys](https://docs.apollo.io/docs/create-api-key)."
},
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "OAuth 2.0 access token, used by Apollo partners building integrations.\nSee the [OAuth 2.0 authorization flow](https://docs.apollo.io/docs/use-oauth-20-authorization-flow-to-access-apollo-user-information-partners)."
}
}
},
"security": [
{
"apiKey": []
},
{
"bearerAuth": []
}
],
"paths": {
"/usage_stats/credit_usage_stats": {
"post": {
"summary": "View credit usage stats",
"description": "## Endpoint essentials\n\n**API key access:** `api/v1/usage_stats/credit_usage_stats` or `Master API key`\n\n**OAuth scopes:** `credit_usage_stats_read`\n\n**Credit usage:** `0 credits` — [Learn more about API pricing and credits](https://docs.apollo.io/docs/api-pricing).\n\nUse the view credit usage stats endpoint to monitor your team's credit balance across every credit type in the current billing cycle.\n\nFor each credit type, the response returns the `limit` (your team's allowance for the cycle), `consumed` (credits used so far), and `left_over` (credits remaining). The `current_credit_cycle` object reports the start and end dates of the billing cycle these stats cover.\n\nBalances reflect your team's running credit usage and update within seconds of a credit-consuming request. To retrieve credit usage for a single user instead of the whole team, use [get current user profile](https://docs.apollo.io/reference/get-current-user-profile) with the `include_credit_usage` query parameter set to `true`.\n\n### Credit types\n\nThe `credit_usage_stats` object is keyed by credit type. Each key funds a different Apollo action:\n\n| Key | What it funds |\n| --- | --- |\n| `lead_credit` | Email address reveals and email enrichment. |\n| `direct_dial_credit` | Mobile and direct dial phone number reveals. |\n| `export_credit` | CSV exports of contacts and accounts. |\n| `conversation_credit` | Conversation intelligence and call recording. |\n| `ai_credit` | AI-generated email writing. |\n| `power_up_credit` | AI power-up field enrichment on contact and account records. |\n| `inbound_website_visitor_credit` | Inbound website visitor identification. |\n| `contact_website_visitor_credit` | Contact-level website visit tracking. |\n| `web_search_record_credit` | Web search enrichment records. |\n| `dialer` | Dialer talk time. Reported in **minutes**, not credits. |\n\nA credit type your Apollo plan doesn't include returns a `limit` of `0`.\n\nIf your team is on a unified credit plan, `lead_credit` is a shared pool: the `left_over` value already accounts for mobile reveals, exports, dialer minutes, and power-up enrichment, so don't add the individual balances together to estimate what's left.",
"tags": [
"Miscellaneous"
],
"operationId": "view-credit-usage-stats",
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"examples": {
"OK": {
"summary": "OK",
"value": "{\n \"credit_usage_stats\": {\n \"lead_credit\": {\n \"limit\": 10000,\n \"consumed\": 2500,\n \"left_over\": 7500\n },\n \"direct_dial_credit\": {\n \"limit\": 1000,\n \"consumed\": 120,\n \"left_over\": 880\n },\n \"export_credit\": {\n \"limit\": 5000,\n \"consumed\": 250,\n \"left_over\": 4750\n },\n \"conversation_credit\": {\n \"limit\": 500,\n \"consumed\": 30,\n \"left_over\": 470\n },\n \"ai_credit\": {\n \"limit\": 2000,\n \"consumed\": 75,\n \"left_over\": 1925\n },\n \"power_up_credit\": {\n \"limit\": 1000,\n \"consumed\": 40,\n \"left_over\": 960\n },\n \"inbound_website_visitor_credit\": {\n \"limit\": 1000,\n \"consumed\": 60,\n \"left_over\": 940\n },\n \"dialer\": {\n \"limit\": 500,\n \"consumed\": 12,\n \"left_over\": 488\n },\n \"web_search_record_credit\": {\n \"limit\": 1000,\n \"consumed\": 0,\n \"left_over\": 1000\n },\n \"contact_website_visitor_credit\": {\n \"limit\": 1000,\n \"consumed\": 15,\n \"left_over\": 985\n }\n },\n \"current_credit_cycle\": {\n \"start_date\": \"2026-04-01T00:00:00.000Z\",\n \"end_date\": \"2026-05-01T00:00:00.000Z\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"credit_usage_stats": {
"type": "object",
"description": "Credit usage for the current billing cycle, keyed by credit type. Every credit type is always returned; a type your Apollo plan doesn't include returns a `limit` of `0`. See the Credit types table above for what each key funds. Values are credits, except `dialer`, which is reported in minutes.",
"additionalProperties": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"example": 10000,
"description": "Credit allowance for the current billing cycle."
},
"consumed": {
"type": "integer",
"example": 2500,
"description": "Credits used so far this cycle. Equals `limit` minus `left_over`, and can be negative if remaining exceeds the allowance."
},
"left_over": {
"type": "integer",
"example": 7500,
"description": "Credits remaining for the current billing cycle."
}
}
}
},
"current_credit_cycle": {
"type": "object",
"description": "Start and end of the billing cycle the stats cover. Both values are `null` when the team has no active billing cycle.",
"properties": {
"start_date": {
"type": "string",
"format": "date-time",
"nullable": true,
"example": "2026-04-01T00:00:00.000Z",
"description": "Start of the current credit cycle."
},
"end_date": {
"type": "string",
"format": "date-time",
"nullable": true,
"example": "2026-05-01T00:00:00.000Z",
"description": "End of the current credit cycle."
}
}
}
}
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"text/plain": {
"examples": {
"Check API Key": {
"value": "Invalid API key. See https://docs.apollo.io/reference/authentication for how to authenticate."
}
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/json": {
"examples": {
"Need Master API Key": {
"value": {
"error": "This API key is not authorized to access api/v1/usage_stats/credit_usage_stats. Request an API key from your administrator that includes this endpoint in its configured scope.",
"error_code": "API_INACCESSIBLE"
},
"summary": "Need Master API Key"
}
}
}
}
}
},
"parameters": []
}
}
},
"x-readme": {
"headers": [
{
"key": "Cache-Control",
"value": "no-cache"
},
{
"key": "Content-Type",
"value": "application/json"
}
],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```