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

# GET /orgs/{org_id}/contacts

`GET /orgs/{org_id}/contacts`

Account-side contacts assigned to an organization.

## Path parameters

- `org_id` string, required

## Response `200`

Contacts for the organization

- ListOrgContactsResBody
  - `contacts` OrgContact[], required
    - `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`.

---

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