---
title: "Get Org"
method: GET
path: "/api/v1/orgs/{org_id}"
tags: ["organizations"]
---

# Get Org

`GET /api/v1/orgs/{org_id}`

## Path parameters

- `org_id` string, required

## Headers

- `Authorization` string, nullable

## Response `200`

Successful Response

- OrganizationRead
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `name` string, required
  - `slug` string, required
  - `clerk_org_id` string, required
  - `plan` 'free' | 'pro' | 'enterprise', required
  - `status` 'pending' | 'active' | 'suspended' | 'deleted', required
  - `metronome_customer_id` string, nullable
  - `entitlements` object
  - `onboarding_state` OrganizationOnboardingState, required
    - `status` 'not_started' | 'existing' | 'in_progress' | 'skipped' | 'completed'
    - `completed_steps` OnboardingStep[]
    - `proxy_id` string, uuid, nullable
    - `started_at` string, date-time, nullable
    - `started_by` string, uuid, nullable
    - `skipped_at` string, date-time, nullable
    - `skipped_by` string, uuid, nullable
    - `completed_at` string, date-time, nullable
    - `completed_by` string, uuid, nullable
  - `viewer_product_tour_eligible` boolean, required
  - `viewer_product_tour_state` UserProductTourState, required
    - `version` integer
    - `status` 'not_started' | 'in_progress' | 'completed' | 'dismissed'
    - `current_step` 'dashboard' | 'proxies' | 'policies' | 'providers' | 'traces' | 'alerts'
    - `visited_steps` ProductTourStep[]
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `dismissed_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-31** `18ce94490752` — 4 info
  - added the optional property `entitlements` to the response with the `200` status
  - added the required property `onboarding_state` to the response with the `200` status
  - added the required property `viewer_product_tour_eligible` to the response with the `200` status
  - added the required property `viewer_product_tour_state` to the response with the `200` status
- **2026-08-25** `e63bfe8e38b4` — 1 breaking, 1 info
  - removed the required property `workos_org_id` from the response with the `200` status
  - added the required property `clerk_org_id` to the response with the `200` status

[Change history](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/orgs/:org_id/get.md)

---

[API](https://skmtc.dev/xenovia/apis/controlplane.md) · [All operations](https://skmtc.dev/xenovia/apis/controlplane/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xenovia/controlplane/revisions/18ce94490752/schema)