---
title: "Get organization information"
method: GET
path: "/v1/organization"
tags: ["Organization"]
---

# Get organization information

`GET /v1/organization`

Get usage tier and credit balance information about the organization associated with the API key used to make the request.

## Headers

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

## Response `200`

Success

- object
  - `tier` object, required — Limits associated with the organization's tier.
    - `maxMonthlyCreditSpend` integer, required — The maximum number of credits that can be purchased in a month.
    - `models` object, required — An object containing model-specific limits. Each key represents a model.
  - `creditBalance` integer, required — The number of credits remaining in the organization account.
  - `usage` object, required — Usage data for the organization.
    - `models` object, required

## Changes

- **2026-06-17** `28f5cd401a4b` — 10 warning
  - added the new `marketing_stock_image` enum value to the `tier/models/propertyNames/` response property for the response status `200`
  - added the new `marketing_stock_image` enum value to the `usage/models/propertyNames/` response property for the response status `200`
  - added the new `multi_shot_video` enum value to the `tier/models/propertyNames/` response property for the response status `200`
  - added the new `multi_shot_video` enum value to the `usage/models/propertyNames/` response property for the response status `200`
  - …6 more
- **2026-06-10** `410e415709b1` — 2 warning
  - added the new `product_swap` enum value to the `tier/models/propertyNames/` response property for the response status `200`
  - added the new `product_swap` enum value to the `usage/models/propertyNames/` response property for the response status `200`
- **2026-06-05** `b9cd8cc6392a` — 2 warning
  - added the new `seedance2_fast` enum value to the `tier/models/propertyNames/` response property for the response status `200`
  - added the new `seedance2_fast` enum value to the `usage/models/propertyNames/` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/runwayml/apis/runwayml-api/changes/v1/organization/get.md)

---

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