Skip to Content
API reference

Get organization

GET /api/v1/organization — retrieve the organization associated with an API key.

GET /api/v1/organization

Returns the organization associated with the supplied API key. This endpoint accepts no body, path parameters, or query parameters.

Request headers

HeaderRequiredValue
X-API-KeyYesAn 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"
}
FieldTypeDescription
idUUID stringOrganization identifier
namestringDisplay name
slugstring or nullOrganization slug, when set
logostring or nullOrganization logo value, when set
createdAtISO 8601 date-time stringCreation timestamp
updatedAtISO 8601 date-time stringMost 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

StatusMeaning
401API key missing, malformed, unknown, expired, or revoked
404Organization no longer exists
500Internal server error
401 Unauthorized
{
	"error": "Unauthorized. API key is missing or invalid."
}

See Errors and troubleshooting for recovery steps, or import this endpoint from the OpenAPI specification.

On this page