---
title: "Get historical credit usage for the authenticated team"
method: GET
path: "/team/credit-usage/historical"
tags: ["Billing"]
---

# Get historical credit usage for the authenticated team

`GET /team/credit-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)
    - `totalCredits` integer — Total number of credits 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)