---
title: "Get historical token usage for the authenticated team (Extract only)"
method: GET
path: "/team/token-usage/historical"
tags: ["Billing"]
---

# Get historical token usage for the authenticated team (Extract only)

`GET /team/token-usage/historical`

## Query parameters

- `byApiKey` boolean

## Response `200`

Successful response

- object
  - `success` boolean
  - `periods` object[]
    - `startDate` string, date-time — Start date of the billing period
    - `endDate` string, date-time — End date of the billing period
    - `apiKey` string, nullable — Name of the API key used for the billing period. null if byApiKey is false (default)
    - `totalTokens` integer — Total number of tokens used in the billing period

## Other responses

- `500` — Server error

---

[API](https://skmtc.dev/firecrawl/apis/firecrawl-api.md) · [All operations](https://skmtc.dev/firecrawl/apis/firecrawl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firecrawl/firecrawl-api/revisions/e350fafb5a2a/schema)