List all organizations

Retrieves a comprehensive list of all organizations accessible to the authenticated user. This endpoint returns organization metadata including names, display names, and timestamps.

Authorization: Requires appropriate permissions to view organizations.

Rate Limiting: Standard rate limits apply.

Pagination: Supports offset-based pagination with limit and offset parameters.

GET /organizations

List all organizations

cURL

curl --request GET \
  --url https://{organization}.admin.credibledata.com/api/v0/organizations \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "name": "<string>",
    "displayName": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "mpaVersion": "<string>"
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit · integer · default: -1

Maximum number of items to return. Use -1 or omit to return all results. Valid values: -1 (all results) or 1–100.

Required range: -1 <= x <= 500

offset · integer · default: 0

Number of items to skip before starting to return results

Required range: x >= 0

Response

200

application/json

List of organizations retrieved successfully

name · string

The unique identifier for the organization. Used as the resource name in API paths AND as the DNS subdomain label routing traffic to the org, so it follows RFC 1035 hostname rules — lowercase letters, digits, and hyphens; no underscores; no leading or trailing hyphen; max 63 chars.

Required string length: 1 - 63

Pattern: ^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$

displayName · string

Human-readable name for the organization, displayed in user interfaces

Required string length: 1 - 128

Pattern: ^[^\u0000-\u001F\u007F]+$

createdAt · string<date-time>

ISO 8601 timestamp indicating when the organization was created

updatedAt · string<date-time>

ISO 8601 timestamp indicating when the organization was last modified

mpaVersion · string · read-only

Version identifier of the Master Platform Agreement the organization accepted at creation time (file basename, e.g. v1-2026-05-19). Server-set: clients do not (and cannot) submit this field — when an organization is created via the invite-redemption path, the server stamps its current active MPA version. Null on legacy organizations created before MPA acceptance was required.

Only the version is exposed on this resource. The per-user / per- timestamp audit fields (mpa_accepted_by, mpa_accepted_at) are kept internal — useful for compliance audit on the server side, not for API consumers. If a future use case needs them on the API, add them then; widening is easier than narrowing.

Required string length: 1 - 32

Pattern: ^[a-zA-Z0-9._-]+$