v1

latestOpenAPI 3.0.32026-07-26279.1 KB

Model Requests

Retrieve per-request model usage for your organization

post/v2/organization/model-requests

Request body

startDateinteger required

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

endDateinteger required

End of the time window as a Unix timestamp in milliseconds

emailstring email

Optional email filter scoped to the organization

cursorstring nullable

Opaque cursor returned by a previous response for pagination

limitinteger

Number of rows to return

Example request

{
  "startDate": 1767222900000,
  "endDate": 1767226560000,
  "email": "user1@firebender.com",
  "cursor": "eyJjcmVhdGVkQXRNcyI6MTc2NzIyNjUwMDAwMCwiaWQiOiIwZjhmYWQ1Yi1kOWNiLTQ2OWYtYTE2NS03MDg2NzcyODk1MGUifQ==",
  "limit": 100
}

Response

Model request data retrieved successfully

nextCursorstring nullable required

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

Example response

{
  "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"
    }
  ]
}