API reference
Get organization
GET /api/v1/organization — retrieve the organization associated with an API key.
GET /api/v1/organizationReturns the organization associated with the supplied API key. This endpoint accepts no body, path parameters, or query parameters.
Request headers
| Header | Required | Value |
|---|---|---|
X-API-Key | Yes | An unexpired organization API key |
curl --fail-with-body https://your-app.example/api/v1/organization \
-H "X-API-Key: $API_KEY"Successful response
Status: 200 OK · Content type: application/json
{
"id": "e052cbd7-3604-48f1-b8dd-bbb2adff11e4",
"name": "Acme",
"slug": "acme",
"logo": null,
"createdAt": "2026-11-03T12:00:00.000Z",
"updatedAt": "2026-11-03T12:00:00.000Z"
}| Field | Type | Description |
|---|---|---|
id | UUID string | Organization identifier |
name | string | Display name |
slug | string or null | Organization slug, when set |
logo | string or null | Organization logo value, when set |
createdAt | ISO 8601 date-time string | Creation timestamp |
updatedAt | ISO 8601 date-time string | Most recent update timestamp |
The response excludes billing identifiers, organization metadata, membership,
SSO settings, and key material. Authenticated responses and errors use
Cache-Control: no-store.
Error responses
| Status | Meaning |
|---|---|
401 | API key missing, malformed, unknown, expired, or revoked |
404 | Organization no longer exists |
500 | Internal server error |
{
"error": "Unauthorized. API key is missing or invalid."
}See Errors and troubleshooting for recovery steps, or import this endpoint from the OpenAPI specification.