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/v2/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.
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.

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[]