Skip to main content
GET
/
billing
/
hard-cap
cURL
curl --request GET \
  --url https://api.useanima.sh/v1/billing/hard-cap \
  --header 'Authorization: Bearer <token>'
{
  "enabled": true,
  "monthlyCapCents": 1,
  "meters": {
    "email": {
      "enabled": true,
      "capCents": 1
    },
    "sms": {
      "enabled": true,
      "capCents": 1
    },
    "voice": {
      "enabled": true,
      "capCents": 1
    }
  }
}

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Response

200 - application/json

OK

Hard-cap settings for the requesting org

enabled
boolean
required

Global hard-cap toggle. When false ALL meters bypass enforcement.

monthlyCapCents
integer
required

Default monthly cap when no per-meter override applies

Required range: x >= 0
meters
object
required

Per-meter configuration; each meter can override mode/cap independently