---
title: "List accessible organizations or fetch one organization by `orgId`."
method: GET
path: "/organization/"
tags: ["organizations"]
---

# List accessible organizations or fetch one organization by \`orgId\`.

`GET /organization/`

## Request

- Base URL: `https://api.capgo.app`
- URL: `https://api.capgo.app/organization/`
- Auth: API key in header `x-api-key`

List organizations the API key can access, or fetch one organization when `orgId` is provided. Use this to resolve the org scope before creating apps or inviting members.

## Query parameters

- `orgId` string

## Response `200`

Organization data.

- union
  - OrganizationEnvelope
    - `data` Organization, required
      - `id` string, required
      - `name` string, required
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `logo` string, uri, nullable
      - `management_email` string, email
      - `customer_id` string, nullable
  - OrganizationListEnvelope
    - `data` Organization[], required
      - `id` string, required
      - `name` string, required
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `logo` string, uri, nullable
      - `management_email` string, email
      - `customer_id` string, nullable

## Other responses

- `401`: The API key is missing, invalid, or expired.
- `403`: The API key is valid but lacks the required scope or org access.
- `429`: Too many requests. Back off and retry later.
- `500`: Unexpected Capgo server error.

---

[API](https://skmtc.dev/capgo/apis/capgo-public-api.md) · [All operations](https://skmtc.dev/capgo/apis/capgo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capgo/apis/capgo-public-api/revisions/8496acb7a95b?raw)