> ## Documentation Index
> Fetch the complete documentation index at: https://docs.communityhub.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /organizations — List Organizations

> List the organizations your token can access, either as lightweight id/name pairs or with full organization metadata.

## Endpoint

```text theme={null}
GET /organizations
```

Returns the organizations the requesting user's token has access to. A token is scoped to the **user**, not to a single organization, so this list may include more than one organization if your account belongs to several. See [Authentication](/api-reference/authentication).

## Response modes

The `mode` query parameter selects between two response shapes:

| Mode           | Query                           | Returns                                                   |
| -------------- | ------------------------------- | --------------------------------------------------------- |
| Full (default) | `GET /organizations`            | `id`, `name`, `meta`, `communityId` for each organization |
| Short          | `GET /organizations?mode=short` | `id`, `name` only                                         |

### Short mode

```bash theme={null}
curl "https://api.communityhub.cloud/dh/public/v1/organizations?mode=short" \
  -H "Authorization: Bearer <token>"
```

```json theme={null}
[
  { "id": "3f8c1a02", "name": "City of Cleveland" },
  { "id": "9d2e77b4", "name": "City of Oberlin" },
  { "id": "6a1f0c9d", "name": "City of Oberlin (Private Organizations)" },
  { "id": "b57e2f81", "name": "Cleveland Foundation" },
  { "id": "e4913dc6", "name": "Great Lakes Science Center" },
  { "id": "0c8a44f7", "name": "Oberlin College" },
  { "id": "77b0e2ad", "name": "Oberlin Public Library" },
  { "id": "d3f6109b", "name": "Oberlin Schools" },
  { "id": "1a9e5c34", "name": "Sustainable Community Associates" },
  { "id": "f206b8e1", "name": "Toledo Public Schools" },
  { "id": "5e0d3a72", "name": "University of Washington Bothell" }
]
```

### Full mode

```bash theme={null}
curl "https://api.communityhub.cloud/dh/public/v1/organizations" \
  -H "Authorization: Bearer <token>"
```

```json theme={null}
[
  {
    "id": "3f8c1a02",
    "name": "City of Cleveland",
    "meta": {},
    "communityId": "a91c04de"
  },
  {
    "id": "9d2e77b4",
    "name": "City of Oberlin",
    "meta": {},
    "communityId": "a91c04de"
  }
]
```

Every organization from short mode is returned in full mode too, with `meta` and `communityId` added — the underlying list is the same.

## Fields

| Field         | Type   | Present in  | Description                                                                                                                                                                     |
| ------------- | ------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | string | short, full | Unique identifier for the organization.                                                                                                                                         |
| `name`        | string | short, full | Display name of the organization.                                                                                                                                               |
| `meta`        | object | full only   | Additional organization metadata. Contents not yet finalized — empty in every example seen so far.                                                                              |
| `communityId` | string | full only   | Identifier of the community the organization belongs to. How this relates to `id` and the organization hierarchy in [Core Concepts](/core-concepts) hasn't been documented yet. |

<Warning>
  **Open — not fully decided.** This page documents the two response shapes exactly as specified, but several details aren't finalized in the source spec:

  * What populates `meta` — every example returns an empty object.
  * What `communityId` refers to, and how it relates to the `id` used elsewhere (for example, as a filter on [`/variables` or `/metered-entities`](/api-reference/query/saved-queries)).
  * Whether `mode=short` and the default (full) response are the only two modes, or more are planned.
  * Sort order of the returned array — examples appear alphabetical by `name`, but this isn't a guaranteed contract.
  * Whether the list supports filtering or pagination, and what's returned if a token has access to zero organizations.
</Warning>

See [Discovery Endpoints](/api-reference/query/saved-queries) for how organizations relate to metered entities and variables, and [Rate Limits](/api-reference/rate-limits) for the request budget.