Skip to main content
POST
/
v2
/
organization
/
model-requests
Model Requests
curl --request POST \
  --url https://api.firebender.com/v2/organization/model-requests \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "startDate": 1767222900000,
  "endDate": 1767226560000,
  "email": "user1@firebender.com",
  "cursor": "eyJjcmVhdGVkQXRNcyI6MTc2NzIyNjUwMDAwMCwiaWQiOiIwZjhmYWQ1Yi1kOWNiLTQ2OWYtYTE2NS03MDg2NzcyODk1MGUifQ==",
  "limit": 100
}
'
{
  "data": [
    {
      "requestId": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "timestamp": "2026-01-01T00:15:00Z",
      "email": "user1@firebender.com",
      "model": "gpt-5.4",
      "inputTokens": 120,
      "cacheReadTokens": 25,
      "outputTokens": 30,
      "cacheWriteTokens": 5,
      "totalTokens": 180,
      "costUsd": 1.2345,
      "spendType": "on-demand",
      "mode": "write"
    }
  ],
  "nextCursor": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.firebender.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Organization API key. Create API Key here

Body

application/json
​
startDate
integer<int64>
required

Start of the time window as a Unix timestamp in milliseconds. Data is only available on or after 2025-12-31T00:00:00Z

Example:

1767222900000

​
endDate
integer<int64>
required

End of the time window as a Unix timestamp in milliseconds

Example:

1767226560000

​
email
string<email>

Optional email filter scoped to the organization

Example:

"user1@firebender.com"

​
cursor
string | null

Opaque cursor returned by a previous response for pagination

Example:

"eyJjcmVhdGVkQXRNcyI6MTc2NzIyNjUwMDAwMCwiaWQiOiIwZjhmYWQ1Yi1kOWNiLTQ2OWYtYTE2NS03MDg2NzcyODk1MGUifQ=="

​
limit
integer
default:100

Number of rows to return

Required range: 1 <= x <= 500
Example:

100

Response

Model request data retrieved successfully

​
data
object[]
required

Array of model request records sorted oldest first

​
nextCursor
string | null
required

Cursor for the next page, or null when there are no more results

Example:

null