Get token usage

Get remaining tokens for Extract feature

Endpoint

GET /v1/team/token-usage

Authentication

This endpoint requires authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Response

success · boolean

Indicates whether the request was successful

data · object

Token usage information

Show properties

remaining_tokens · number

Number of tokens remaining for the team

Examples

cURL

curl -X GET https://api.firecrawl.dev/v1/team/token-usage \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response Example

{
  "success": true,
  "data": {
    "remaining_tokens": 1000
  }
}

Error Responses

404 · object

Not Found - Could not find token usage information.

{
  "success": false,
  "error": "Could not find token usage information"
}

500 · object

Server Error - Internal server error while fetching token usage.

{
  "success": false,
  "error": "Internal server error while fetching token usage"
}