# Token Usage (/api-reference/endpoint/token-usage)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 786 · updated: 2026-07-30 -->
Related: [Search](/api-reference/endpoint/search.md), [Search Feedback](/api-reference/endpoint/search-feedback.md), [Scrape](/api-reference/endpoint/scrape.md), [Batch Scrape](/api-reference/endpoint/batch-scrape.md), [Get Batch Scrape Status](/api-reference/endpoint/batch-scrape-get.md), [Cancel Batch Scrape](/api-reference/endpoint/batch-scrape-delete.md)

<Info>
  We've simplified billing so that Extract now uses credits, just like all of the other endpoints. Each credit is worth 15 tokens. Reported token usage now includes usage from all endpoints.
</Info>

> Are you an AI agent that needs a Firecrawl API key? See [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for automated onboarding instructions.

`GET /team/token-usage`

Get remaining tokens for the authenticated team (Extract only)

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "responses": {
    "200": {
      "description": "Successful response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean",
                "example": true
              },
              "data": {
                "type": "object",
                "properties": {
                  "remainingTokens": {
                    "type": "number",
                    "description": "Number of tokens remaining for the team",
                    "example": 1000
                  },
                  "planTokens": {
                    "type": "number",
                    "description": "Number of tokens in the plan. This does not include coupon tokens.",
                    "example": 500000
                  },
                  "billingPeriodStart": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Start date of the current billing period.",
                    "example": "2025-01-01T00:00:00Z",
                    "nullable": true
                  },
                  "billingPeriodEnd": {
                    "type": "string",
                    "format": "date-time",
                    "description": "End date of the current billing period.",
                    "example": "2025-01-31T23:59:59Z",
                    "nullable": true
                  }
                }
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "Token usage information not found",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean",
                "example": false
              },
              "error": {
                "type": "string",
                "example": "Could not find token usage information"
              }
            }
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean",
                "example": false
              },
              "error": {
                "type": "string",
                "example": "Internal server error while fetching token usage"
              }
            }
          }
        }
      }
    }
  }
}
```