Organization

Get the connected organization

GET /api/v1/organization

Required scope: organization:read

Returns the organization bound to the authenticated API key or OAuth connection. There are no path or query parameters. Supplying an organization ID cannot switch the connected organization.

curl "https://app.erzycall.com/api/v1/organization" \
  -H "X-API-Key: ek_live_abc123"

{
  "data": {
    "id": "org_example",
    "name": "Example Company",
    "description": "Customer support",
    "contactEmail": "support@example.com",
    "contactPhone": "+14155550100",
    "createdAt": "2026-09-01T09:00:00.000Z",
    "updatedAt": "2026-09-17T09:00:00.000Z"
  }
}

id is the Clerk organization ID. name is the ErzyCall profile's display name. Optional description and contact fields are null when unset. Timestamps describe creation and last update of the ErzyCall profile and use ISO 8601 UTC.

The endpoint returns 404 NOT_FOUND if no profile exists for the connected organization. Use Usage for current billing and plan information.

MCP exposes the same read as get_organization, with no arguments. Existing OAuth connections, including legacy wildcard grants, need fresh authorization for organization:read. Refreshing an old token does not add the permission. API keys with full access (*) can read this endpoint; scoped keys need organization:read.