---
title: "GET /orgs/{org_id}"
method: GET
path: "/orgs/{org_id}"
tags: ["orgs"]
---

# GET /orgs/{org_id}

`GET /orgs/{org_id}`

Get an organization by ID

## Path parameters

- `org_id` string, required

## Response `200`

Organization details

- GetOrgResBody
  - `org` Org, required
    - `banner_url` string, nullable
    - `contact_email` string, nullable
    - `contact_name` string, nullable
    - `contact_phone` string, nullable
    - `country` string, nullable
    - `created_at` string, date-time, required
    - `description` string, nullable
    - `id` integer, required
    - `name` string, required
    - `overage_cap_credits` integer, nullable
    - `overage_enabled` boolean, required
    - `photo_url` string, nullable
    - `plan` string, required
    - `plan_cancel_at` integer, nullable — Unix timestamp (seconds) of the scheduled plan cancellation; `null` when no cancellation is pending.
    - `plan_cancel_at_period_end` boolean, required — `true` between the moment a user schedules a plan cancellation in the Billing Portal and the final cancellation taking effect.
    - `plan_metadata` unknown, required
    - `role` string, required

## Changes

- **2026-05-07** `ceedf3f59b46` — 1 breaking, 1 warning, 2 info
  - removed the required property `org/credits_per_usd` from the response with the `200` status
  - removed the optional property `org/stripe_customer_id` from the response with the `200` status
  - added the optional property `org/plan_cancel_at` to the response with the `200` status
  - added the required property `org/plan_cancel_at_period_end` to the response with the `200` status
- **2026-05-06** `e9d629bcf1cd` — 1 breaking
  - removed the required property `org/contacts` from the response with the `200` status
- **2026-05-06** `bee7dcae732e` — 1 info
  - added the required property `org/contacts` to the response with the `200` status
- **2026-04-10** `a000b8d9f612` — 2 info
  - added the optional property `org/overage_cap_credits` to the response with the `200` status
  - added the required property `org/overage_enabled` to the response with the `200` status
- **2026-03-16** `eb2c08128881` — 3 breaking, 7 warning, 2 info
  - removed the required property `org/billing_suspended` from the response with the `200` status
  - removed the required property `org/overage_enabled` from the response with the `200` status
  - removed the required property `org/plan_cancel_at_period_end` from the response with the `200` status
  - removed the optional property `org/overage_cap_credits` from the response with the `200` status
  - …8 more

[Change history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/get.md)

---

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