Retrieve organization completion usage

GET /v1/organization/usage/completions

Retrieve organization completion usage

cURL

curl --request GET \
  --url https://api.abliteration.ai/v1/organization/usage/completions \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "start_time": 123,
      "end_time": 123,
      "results": [
        {
          "input_tokens": 123,
          "input_cached_tokens": 123,
          "input_cache_write_tokens": 123,
          "input_uncached_tokens": 123,
          "output_tokens": 123,
          "num_model_requests": 123,
          "object": "organization.usage.completions.result",
          "input_text_tokens": 123,
          "output_text_tokens": 123,
          "input_cached_text_tokens": 123,
          "input_audio_tokens": 123,
          "input_cached_audio_tokens": 123,
          "output_audio_tokens": 123,
          "input_image_tokens": 123,
          "input_cached_image_tokens": 123,
          "output_image_tokens": 123,
          "project_id": "<string>",
          "user_id": null,
          "api_key_id": "<string>",
          "model": "<string>",
          "batch": null,
          "service_tier": null
        }
      ],
      "object": "bucket"
    }
  ],
  "has_more": true,
  "object": "page",
  "next_page": "<string>"
}

Authorizations

Authorization · string · header · required

Organization Admin API key or OAuth access token.

Query Parameters

start_time · integer · required

Start of the reporting window as Unix seconds.

Required range: x >= 0

end_time · integer | null

End of the reporting window as Unix seconds.

Required range: x >= 0

bucket_width · enum<string> · default: 1d

Width of each usage bucket.

Available options: 1m, 1h, 1d

project_ids · string[] | null

Public project IDs to include.

Maximum array length: 100

api_key_ids · string[] | null

Public API key IDs to include.

Maximum array length: 100

models · string[] | null

Model names to include.

Maximum array length: 100

group_by · string[] | null

Dimensions to group within each bucket.

Maximum array length: 3

limit · integer · default: 7

Maximum number of usage buckets to return.

Required range: 1 <= x <= 1440

page · string | null

Opaque page cursor.

Required string length: 1 - 500

Response

200

application/json

Successful Response

data · AdministrationUsageBucket · object[] · required

Show child attributes

has_more · boolean · required

object · string · default: page

Allowed value: "page"

next_page · string | null