Track usage

Access organization usage data programmatically

These endpoints support either an organization API key in the X-API-Key header or a valid signed-in authorization token for a user who belongs to the organization.

Generate an organization API key from your team’s Settings → API Keys page.

Daily usage data

Retrieve daily usage statistics for your organization.

Endpoint: POST https://api.firebender.com/v2/organization/daily-usage-data

Example

curl https://api.firebender.com/v2/organization/daily-usage-data \
  -H "X-API-Key: firebender_your_org_api_key_here" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"startDate": 1752144000000, "endDate": 1752230400000}' \
  | jq

{
  "data": [
    {
      "date": 1752192000000,
      "ideOpened": true,
      "agentPrompts": 4,
      "agentAccepts": 3,
      "agentFullAccepts": 1,
      "agentAcceptedLinesAdded": 134,
      "agentAcceptedLinesRemoved": 37,
      "inlineEdits": 0,
      "inlineEditAccepts": 0,
      "inlineAcceptedLinesAdded": 23,
      "inlineAcceptedLinesRemoved": 12,
      "autocompleteAccepts": 2,
      "autocompleteShown": 6,
      "autocompleteAcceptedCharactersAdded": 237,
      "autocompleteAcceptedCharactersRemoved": 0,
      "email": "[e-mail]"
    }
  ],
  "period": {
    "startDate": 1752144000000,
    "endDate": 1752230400000
  }
}

Request Parameters

Parameter	Type	Required	Description
startDate	number	Yes	Unix timestamp in milliseconds for the start date
endDate	number	Yes	Unix timestamp in milliseconds for the end date

Response Fields

Field	Type	Description
data	array	Array of daily usage records
data[].date	number	Unix timestamp for the day
data[].ideOpened	boolean	Whether the IDE was opened that day
data[].agentPrompts	number	Number of agent prompts sent
data[].agentAccepts	number	Number of agent suggestions accepted (file accepted, individual hunk accepted)
data[].agentFullAccepts	number	Number of full agent suggestions accepted (user accepted all changes at once)
data[].agentAcceptedLinesAdded	number	Lines added through agent accepts
data[].agentAcceptedLinesRemoved	number	Lines removed through agent accepts
data[].inlineEdits	number	Number of inline edits performed
data[].inlineEditAccepts	number	Number of inline edit accepts
data[].inlineAcceptedLinesAdded	number	Lines added through inline accepts
data[].inlineAcceptedLinesRemoved	number	Lines removed through inline accepts
data[].autocompleteAccepts	number	Number of autocomplete accepts
data[].autocompleteShown	number	Number of times autocomplete was shown
data[].autocompleteAcceptedCharactersAdded	number	Characters added through autocomplete
data[].autocompleteAcceptedCharactersRemoved	number	Characters removed through autocomplete
data[].email	string	User email address
period	object	Request period information
period.startDate	number	Requested start date timestamp
period.endDate	number	Requested end date timestamp

Model requests

Retrieve per-request model usage for your organization, including tokens, cost, and request mode.

Endpoint: POST https://api.firebender.com/v2/organization/model-requests

Example

curl https://api.firebender.com/v2/organization/model-requests \
  -H "X-API-Key: firebender_your_org_api_key_here" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "startDate": 1767222900000,
    "endDate": 1767226560000
  }' \
  | jq

{
  "data": [
    {
      "requestId": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "timestamp": "2026-01-01T00:15:00Z",
      "email": "[e-mail]",
      "model": "gpt-5.4",
      "inputTokens": 120,
      "cacheReadTokens": 25,
      "outputTokens": 30,
      "cacheWriteTokens": 5,
      "totalTokens": 180,
      "costUsd": 1.2345,
      "spendType": "on-demand",
      "mode": "write"
    }
  ],
  "nextCursor": null
}

Request Parameters

Parameter	Type	Required	Description
startDate	number	Yes	Start of the time window as a Unix timestamp in milliseconds. Data is only available on or after 2025-12-31T00:00:00Z
endDate	number	Yes	End of the time window as a Unix timestamp in milliseconds. Must be greater than startDate
email	string	No	Filter results to a single user email within the organization
limit	number	No	Number of rows to return. Defaults to 100 and caps at 500
cursor	string	No	Opaque cursor returned in a previous response to fetch the next page

Response Fields

Field	Type	Description
data	array	Array of model request records sorted oldest first
data[].requestId	string	Unique request identifier
data[].timestamp	string	Request timestamp in ISO 8601 format
data[].email	string	User email address
data[].model	string	Model identifier used for the request. See Models for valid model IDs
data[].inputTokens	number	Input tokens billed for the request
data[].cacheReadTokens	number	Cache read tokens billed for the request
data[].outputTokens	number	Output tokens billed for the request
data[].cacheWriteTokens	number	Cache write tokens billed for the request
data[].totalTokens	number	Sum of input, cache read, output, and cache write tokens
data[].costUsd	number	Request cost in USD
data[].spendType	enum	Spending bucket for the request: included for plan-included usage, on-demand for metered overage usage, or byok for bring-your-own-key usage
data[].mode	string	Agent mode when available. Built-in modes include write, plan, ask, and debug. This can also be another user-defined string for custom agents. See Agents/Subagents
nextCursor	string or null	Cursor for the next page, or null when there are no more results

Notes

• Date ranges cannot exceed 90 days.
• Data is only returned for requests on or after 2025-12-31T00:00:00Z.
• Very recent non-final requests may be withheld briefly to avoid returning unstable data.