Get Organization Recharge Policy

GET/v1/organizations/{organization_id}/billing/recharge_policy

Get the organization’s recharge configuration: the top-up mode, the fixed and proportional threshold components, and when the current mode took effect.

Path ParametersExpand Collapse

organization_id: string

ReturnsExpand Collapse

OrganizationRechargePolicy object { policy, policy_args, policy_since }

An organization’s current recharge policy. policy_args is null for a manual policy.

policy: RechargePolicyMode

Policy is the top-up mode.

One of the following:

"manual"

"automatic"

policy_args: AutomaticPolicyArgs { fixed, runway_days, monthly_cap }

PolicyArgs carries the threshold parameters. Required when policy is “automatic”; must be omitted when policy is “manual”.

fixed: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

runway_days: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

monthly_cap: optional string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal

policy_since: string

PolicySince is when the policy currently in force took effect. Any change moves it, including an edit to the threshold parameters of an automatic policy.

formatdate-time

Get Organization Recharge Policy

curl https://api.nirvanalabs.io/v1/organizations/$ORGANIZATION_ID/billing/recharge_policy \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"

{
  "policy": "automatic",
  "policy_args": {
    "fixed": "-69125",
    "runway_days": "-69125",
    "monthly_cap": "-69125"
  },
  "policy_since": "2026-07-30T12:00:00Z"
}

Returns Examples

{
  "policy": "automatic",
  "policy_args": {
    "fixed": "-69125",
    "runway_days": "-69125",
    "monthly_cap": "-69125"
  },
  "policy_since": "2026-07-30T12:00:00Z"
}