---
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
    - `contacts` OrgContact[], required — Account-side contacts assigned to this organization (e.g. AI Solutions Architect, Account Executive). Typically populated for enterprise plans.
      - `channels` OrgContactChannel[], required — Ways to reach this contact.
        - `kind` 'email' | 'phone' | 'whatsapp' | 'telegram' | 'slack' | 'calendly' | 'linkedin' | 'signal' | 'other', required
        - `label` string, nullable — Optional display label like "Mobile" or "Work".
        - `primary` boolean — Marks the preferred channel of this kind when multiple are listed.
        - `value` string, required — Channel-specific identifier: email address, E.164 phone number, slack handle, calendly URL, etc. Format is enforced by the channel kind.
      - `id` string, required — Unique contact identifier.
      - `name` string, required — Display name (e.g. "Jane Doe").
      - `photo_url` string, nullable — Optional profile photo URL.
      - `title` string, nullable — Optional job title (e.g. "Senior AI Solutions Architect").
      - `type` 'aisa' | 'account_executive' | 'account_manager' | 'csm' | 'other', required — Role a contact plays for the org. Free-form on the wire/DB so new roles can be introduced without a migration; unknown values fall back to `Other`.
    - `country` string, nullable
    - `created_at` string, date-time, required
    - `credits_per_usd` number, double, 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_metadata` unknown, required
    - `role` string, required
    - `stripe_customer_id` string, nullable

## Changes

- **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/bee7dcae732e/schema)