> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization

> Retrieve details about your organization.

Fetch the current state of your organization, including which model providers are configured, your subscription tier, and how many instances you're running.

<Note>
  Requires an **organization key** (`chd_org_*`). Scoped keys cannot access this endpoint.
</Note>

## Response

Returns `200 OK` with the organization object.

<ResponseField name="id" type="string">Unique organization ID (UUID).</ResponseField>
<ResponseField name="name" type="string">Your organization's name.</ResponseField>

<ResponseField name="model_providers" type="string[]">
  Providers that have API keys configured (e.g. `["anthropic", "openai"]`). The actual keys are never exposed.
</ResponseField>

<ResponseField name="subscription_tier" type="string">Current plan — `"shrimp"`, `"lobster"`, etc.</ResponseField>
<ResponseField name="instance_limit" type="integer">Maximum number of active instances your plan allows.</ResponseField>
<ResponseField name="instance_count" type="integer">How many active (non-terminated) instances you currently have.</ResponseField>
<ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
<ResponseField name="updated_at" type="string">ISO 8601 timestamp.</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  curl https://api.chowder.dev/v1/organization \
    -H "Authorization: Bearer chd_org_abc123..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Acme Corp",
    "model_providers": ["anthropic", "openai"],
    "subscription_tier": "shrimp",
    "instance_limit": 1,
    "instance_count": 1,
    "created_at": "2026-02-14T12:00:00.000000+00:00",
    "updated_at": "2026-02-14T14:30:00.000000+00:00"
  }
  ```
</ResponseExample>