List my organizations

GET/v1/organizations

Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.

ReturnsExpand Collapse

organizations: array of { id, idp_org_id, idp_provider, 3 more }

id: string

Prefixed organization identifier (org_<base64-encoded-uuid>).

idp_org_id: string

IdP-issued tenant id (WorkOS org id).

idp_provider: "workos" or "vitable"

workos - WorkOS
vitable - Vitable

One of the following:

"workos"

"vitable"

name: string

Human-readable organization name.

super_in: boolean

Whether this organization reads across every organization.

type: "BROKERAGE" or "TPA" or "GENERAL_AGENT" or 3 more

BROKERAGE - Brokerage
TPA - TPA
GENERAL_AGENT - General Agent
CHANNEL_PARTNER - Channel Partner
CONSULTING_FIRM - Consulting Firm
API_PLATFORM - API Platform

One of the following:

"BROKERAGE"

"TPA"

"GENERAL_AGENT"

"CHANNEL_PARTNER"

"CONSULTING_FIRM"

"API_PLATFORM"

total: number

Total number of organizations the caller belongs to.

List my organizations

curl https://api.vitablehealth.com/v1/organizations

{
  "organizations": [
    {
      "id": "org_abc123def456",
      "name": "Acme Brokerage",
      "type": "BROKERAGE",
      "idp_org_id": "org_01J0WORKOS",
      "idp_provider": "workos",
      "super_in": false
    }
  ],
  "total": 1
}

Returns Examples

{
  "organizations": [
    {
      "id": "org_abc123def456",
      "name": "Acme Brokerage",
      "type": "BROKERAGE",
      "idp_org_id": "org_01J0WORKOS",
      "idp_provider": "workos",
      "super_in": false
    }
  ],
  "total": 1
}