GET /organizations — List Organizations

Endpoint

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.

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

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

[
  { "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

curl "https://api.communityhub.cloud/dh/public/v1/organizations" \
  -H "Authorization: Bearer <token>"

[
  {
    "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 hasn’t been documented yet.

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).
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.

See Discovery Endpoints for how organizations relate to metered entities and variables, and Rate Limits for the request budget.

Overview

Data Ingestion (Not Available)

Retrieving Data

Webhooks (Not Available)

Sample Code (No SDKs)

GET /organizations — List Organizations

Endpoint

Response modes

Short mode

Full mode

Fields

​Endpoint

​Response modes

​Short mode

​Full mode

​Fields

Endpoint

Response modes

Short mode

Full mode

Fields