The organization object

Shape of the Organization resource: credit balance and trial dates.

The Organization resource represents the workspace your API key is scoped to. It carries the credit balance and the trial dates.

Object shape

{
  "id": "org_64f1c0ef2ec711ef6dc1dcf",
  "name": "Macha AI",
  "slug": "macha-ai",
  "status": "active",
  "credits": {
    "total": 50000,
    "used": 12345,
    "remaining": 37655,
    "top_up": 0,
    "reset_at": "2026-07-01T00:00:00.000Z"
  },
  "trial": null,
  "created_at": "2026-05-01T00:00:00.000Z"
}

Attributes

Field	Type	Notes
`id`	string	`org_<24 hex>`.
`name`	string	Display name.
`slug`	string	URL-safe identifier.
`status`	string	Subscription status.
`credits`	object	See below.
`trial`	object \| null	Trial dates (`start_date`, `end_date`) or null if not on trial.
`created_at`	ISO 8601	When the org was created.

Credits shape

Field	Type	Notes
`total`	integer	Plan allotment per billing period.
`used`	integer	Consumed this period.
`remaining`	integer	What's left, including any top-up.
`top_up`	integer	Additional credits purchased on top of the plan.
`reset_at`	ISO 8601 \| null	When credits reset (next billing cycle).

What's deliberately not exposed

Chargebee customer IDs / subscription IDs, billing internals stay server-side.
Org-provided LLM API keys, if you've configured BYO keys, they're encrypted at rest and never returned.
Internal flags, super-admin allowlists, beta feature flags, etc.