---
title: "PUT /billing/overage"
method: PUT
path: "/billing/overage"
---

# PUT /billing/overage

`PUT /billing/overage`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/billing/overage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- object: Patch for overage settings; missing fields preserve current values
  - `enabled` boolean: Opt in to (or out of) metered overage
  - `limitCents` integer: Overage to authorize above the included allowance, in cents
  - `monthlySpendCents` integer, nullable: Absolute ceiling; null CLEARS it, omitting the field leaves it unchanged

## Response `200`

OK

- object: Metered-overage authorization for the requesting org
  - `enabled` boolean, required: Whether the customer has opted in to metered overage
  - `limitCents` integer, required: Overage the customer authorized above their included allowance, in cents
  - `monthlySpendCents` integer, nullable, required: Customer's own absolute ceiling; lowers the cap but never raises it
  - `effectiveCapCents` integer, required: What enforcement actually compares spend against; 0 when overage is off
  - `usedCents` integer, required: Metered overage accrued so far this billing period, in cents
  - `planCeilingCents` integer, nullable, required: Most this plan permits authorizing; null on Enterprise (no ceiling)
  - `period` string, required: Billing-period key the usage figure covers

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)