Skip to main content
GET
/
team
/
token-usage
/
historical
Get historical token usage for the authenticated team (Extract only)
curl --request GET \
  --url https://api.firecrawl.dev/v1/team/token-usage/historical \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "periods": [
    {
      "startDate": "2025-01-01T00:00:00Z",
      "endDate": "2025-01-31T23:59:59Z",
      "apiKey": "<string>",
      "totalTokens": 1000
    }
  ]
}
Returns historical token usage on a month-by-month basis. The endpoint can also breaks usage down by API key optionally.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
byApiKey
boolean
default:false

Get historical token usage by API key

Response

Successful response

​
success
boolean
Example:

true

​
periods
object[]