---
title: "Query credit usage"
method: POST
path: "/v1/organization/usage"
tags: ["Organization"]
---

# Query credit usage

`POST /v1/organization/usage`

Fetch credit usage data broken down by model and day for the organization associated with the API key used to make the request. Up to 90 days of data can be queried at a time.

## Headers

- `X-Runway-Version` '2024-11-06', required

## Request body

- object
  - `startDate` string, date — The start date of the usage data in ISO-8601 format (YYYY-MM-DD). If unspecified, it will default to 30 days before the current date. All dates are in UTC.
  - `beforeDate` string, date — The end date of the usage data in ISO-8601 format (YYYY-MM-DD), not inclusive. If unspecified, it will default to thirty days after the start date. Must be less than or equal to 90 days after the start date. All dates are in UTC.

## Response `200`

Success

- object
  - `results` object[], required
    - `date` string, date, required — The date of the usage data in ISO-8601 format (YYYY-MM-DD). All dates are in UTC.
    - `usedCredits` object[], required — The credits used per model for the given date.
      - `model` 'gen4.5' | 'gen3a_turbo' | 'gen4_turbo' | 'gen4_image' | 'gen4_image_turbo' | 'gpt_image_2' | 'act_two' | 'gen4_aleph' | 'veo3' | 'veo3.1' | 'veo3.1_fast' | 'gemini_2.5_flash' | 'gemini_image3_pro' | 'gemini_image3.1_flash' | 'seedream5_pro' | 'seedream5_lite' | 'gemini_omni_flash' | 'eleven_multilingual_v2' | 'seed_audio' | 'eleven_v3' | 'eleven_text_to_sound_v2' | 'eleven_voice_isolation' | 'eleven_voice_dubbing' | 'eleven_multilingual_sts_v2' | 'eleven_scribe_v2' | 'gwm1_avatars' | 'gwm1_avatar_async_audio_to_video' | 'gwm1_avatar_async_text_to_video' | 'voice_processing' | 'seedance2' | 'seedance2_5' | 'seedance2_fast' | 'seedance2_mini' | 'hailuo3' | 'magnific_precision_upscaler_v2' | 'magnific_video_upscaler_creative' | 'kling2.5_turbo_pro' | 'kling3.0_pro' | 'kling3.0_4k' | 'kling3.0_standard' | 'klingO3_pro' | 'klingO3_standard' | 'klingO3_4k' | 'happyhorse_1_0' | 'aleph2' | 'product_swap' | 'product_ad' | 'multi_shot_video' | 'product_ugc' | 'marketing_stock_image' | 'product_campaign_image' | 'ad_localization', required — The model that credits were spent on.
      - `amount` integer, required — The net number of credits spent on the model. May be negative if refunds exceeded charges on this day.
  - `models` string[], required — The list of models with usage during the queried time range.
  - `apiKeys` string[] — Reserved for future use.
  - `resultsByApiKey` object[] — Reserved for future use.
    - `date` string, date, required
    - `usedCredits` object[], required
      - `apiKeyId` string, uuid, required
      - `amount` integer, required

---

[API](https://skmtc.net/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.net/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/cbbe796a13a0/schema)