Get the organization's entitlements

GET/v1/billing/entitlements

Get the organization's entitlements.

Returns the limits and features the organization has now: its plan's values, with any adjustments made for the organization applied. A null limit means no limit. The values apply to the whole organization (limits named per workspace apply to each workspace); workspace_id is only echoed back.

Requires a member of the organization (any role), or an organization-scoped va_ key with the admin or member role. A workspace-scoped key is refused with 403.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Query parameters

organizationstringrequired
the organization's slug
workspace_idstring<uuid>
a workspace id (UUID), returned as workspace_id; it does not change the values

Responses

200application/json

workspace_idstring<uuid>
The workspace id (UUID) the request named, returned as sent; it does not change the values.
plan_namestring
The name of the organization's plan.
max_virtual_keysinteger<int32>
The most virtual keys each workspace can have. Null means no limit.
max_consumer_keysinteger<int32>
Not used; always null.
max_rpminteger<int32>
The most requests per minute each workspace can send through the gateway; more are refused with 429. Null means no limit.
max_monthly_budget_usdnumber<double>
The stated monthly spend ceiling, in USD. For information: requests are not refused when it is reached. Null means no limit.
max_logs_per_monthinteger<int32>
The most request logs stored per month; requests over it are still served but not logged. Null means no limit.
log_retention_daysinteger<int32>
How many days request logs are kept before they are deleted. Null means they are kept until the organization is closed.
max_prompt_templatesinteger<int32>
The most prompts each workspace can have. Null means no limit.
max_guardrailsinteger<int32>
The most guardrails each workspace can have. Null means no limit.
max_api_keysinteger<int32>
The most platform API keys (va_...) the organization can have. Null means no limit.
semantic_caching_enabledboolean
Whether the organization can use the semantic cache (x-cache-mode: semantic).
ai_guardrails_enabledboolean
Whether the organization can use the AI guardrail checks; saving a guardrail with one fails with 402 otherwise.
mcp_gateway_enabledboolean
Whether the organization can use the MCP Gateway.
tool_inventory_enabledboolean
Whether the organization can read the tool inventory.
trust_pack_enabledboolean
Whether the organization can read the AI Trust Pack reports.
trust_controls_enabledboolean
Whether the organization can use the AI Trust Pack controls.
subscription_statusenum<string>
The subscription's status: active, trialing, past_due or canceled.
One of "active", "past_due", "canceled", "trialing"

VectorAxis is built by GK Labs, a member of NVIDIA Inception.