Skip to navigation
API ReferenceOrganizations

Get Organization

Returns the organization for the authenticated API key (usage limits, counts, and billing metadata).

CLI:

agentmail organizations get

Authentication

AuthorizationBearer

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

Response

This endpoint returns an object.
organization_idstring
ID of organization.
inbox_countinteger
Current number of inboxes.
domain_countinteger
Current number of domains.
updated_atdatetime
Time at which organization was last updated.
created_atdatetime
Time at which organization was created.
inbox_limitintegerOptional
Maximum number of inboxes allowed.
domain_limitintegerOptional
Maximum number of domains allowed.
billing_idstringOptional

Provider-agnostic billing customer ID.

billing_typestringOptional

Billing provider type (e.g. “stripe”).

billing_subscription_idstringOptional
Active billing subscription ID.
authentication_idstringOptional

Provider-agnostic authentication ID.

authentication_typestringOptional
Authentication provider type.
suspended_atdatetimeOptional

Time at which the organization was suspended. Absent when it is not suspended. A suspended organization cannot send, but it still receives mail, its webhooks and WebSocket events still fire, and API reads keep working. See account_suspended.

suspended_reasonstringOptional

Why the organization is suspended, in a short machine-readable form such as message.bounced or message.complained. Absent when it is not suspended. Email support@agentmail.cc to resolve a suspension.