Token Usage

1 min read

get/team/token-usage

Request example

curl --request GET \
  --url https://api.firecrawl.dev/v2/team/token-usage \
  --header 'Authorization: Bearer <token>'

Response

{
  "success": true,
  "data": {
    "remainingTokens": 1000,
    "planTokens": 500000,
    "billingPeriodStart": "2025-01-01T00:00:00Z",
    "billingPeriodEnd": "2025-01-31T23:59:59Z"
  }
}

get/team/token-usage

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.

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Authorization

Authorizationstringheaderrequired#

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

Responses

application/json

Successful response

successboolean#

dataobject#

Show child attributes

remainingTokensnumber#

Number of tokens remaining for the team

planTokensnumber#

Number of tokens in the plan. This does not include coupon tokens.

billingPeriodStartstring#

Start date of the current billing period.

billingPeriodEndstring#

End date of the current billing period.

Historical Credit Usage Historical Token Usage