---
title: "Get organization details"
method: GET
path: "/customerbase/v1/organizations/{id}"
tags: ["CustomerBASE API"]
---

# Get organization details

`GET /customerbase/v1/organizations/{id}`

Retrieves detailed organization information by ID or COS ID

## Path parameters

- `id` string, required

## Response `200`

Organization found

- CustomerbaseOrganizationResponse — Response structure for single organization operations
  - `organization` CustomerbaseOrganizationRecord — Detailed organization information returned by API operations
    - `cosId` string — CustomerOS unique identifier example: C-A12-B45
    - `customId` string — Custom ID provided by the user example: 12345
    - `domains` string[] — Associated domains example: ["customeros.com","customeros.ai"]
    - `externalLinks` CustomerbaseExternalLink[] — External system links
      - `id` string — External system identifier example: cos-12345
      - `name` string — External system name example: stripe
      - `primary` boolean — Indicates if this is the primary link example: true
    - `icpFit` boolean — ICP fit indicator example: true
    - `id` string — Organization's unique identifier example: 123e4567-e89b-12d3-a456-426614174000
    - `leadSource` string — Lead source of the organization example: Web Search
    - `name` string — Organization name example: CustomerOS
    - `relationship` string — Relationship status with the organization example: customer
    - `stage` string — Current stage in the organization lifecycle example: lead
    - `website` string — Organization's website URL example: https://customeros.ai
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")

## Other responses

- `206` — Organization found with partial data
- `400` — Invalid organization ID format
- `401` — Unauthorized - Invalid or missing API key
- `404` — Organization not found
- `500` — Internal server error

## Changes

- **2026-07-17** `73526747b270` — 1 info
  - added the success response with the status `206`
- **2024-10-16** `3087b1c760de` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/customerbase/v1/organizations/:id/get.md)

---

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