GET
/
team
/
token-usage
Get remaining tokens for the authenticated team (Extract only)
curl --request GET \
  --url https://api.firecrawl.dev/v2/team/token-usage \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "remainingTokens": 1000,
    "planTokens": 500000,
    "billingPeriodStart": "2025-01-01T00:00:00Z",
    "billingPeriodEnd": "2025-01-31T23:59:59Z"
  }
}

​
What’s New in v2

​
See Where Your Tokens Go

  • Track tokens used by FIRE-1 agent
  • See costs for URL-free extractions
  • Monitor tokens for complex data extraction
  • Better tracking for batch extractions

​
More Token Details

  • See tokens for complex web interactions
  • Track extra tokens for JavaScript-heavy sites
  • Monitor tokens for improved accuracy
  • See costs for automatic pagination

​
Faster and More Accurate

  • Quicker access to token usage data
  • Better cost breakdowns for Extract features
  • More precise tracking of FIRE-1 operations
Same API as v1, better visibility into token usage for v2 Extract features.

Authorizations

​
Authorization
string
header
required

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

Response

Successful response

​
success
boolean
Example:

true

​
data
object