List spend limits

GET

https://api.runledger.co/v1/spend_limits

GET

/v1/spend_limits

curl https://api.runledger.co/v1/spend_limits \
     -H "Authorization: Bearer <api_key>"

{
  "object": "string",
  "data": [
    {
      "id": "sl_4kP7wD2nRt",
      "object": "string",
      "applies_to": {
        "customer": "string",
        "plan": "string",
        "agent_id": "string",
        "member_id": "string",
        "team_id": "string",
        "pool": "string"
      },
      "period": {
        "duration": "P1M",
        "anchor": "calendar"
      },
      "amount": {
        "amount": 1500,
        "currency": "usd"
      },
      "counts": "paid_usage",
      "action": "warn",
      "set_by": "operator",
      "enabled": true,
      "livemode": true,
      "created_at": "2024-01-15T09:30:00Z",
      "key": "team_monthly_cap",
      "ceiling": {
        "amount": 1500,
        "currency": "usd"
      },
      "alert_at": [
        "string"
      ],
      "current": {
        "spent": {
          "amount": 1500,
          "currency": "usd"
        },
        "held": {
          "amount": 1500,
          "currency": "usd"
        },
        "period_start": "2024-01-15T09:30:00Z",
        "resets_at": "2024-01-15T09:30:00Z"
      },
      "actor": {
        "type": "user",
        "id": "usr_4tN8vB2cXk",
        "name": "Claude Code",
        "on_behalf_of": "usr_4tN8vB2cXk",
        "client": "claude-code"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Newest first.

Authentication

AuthorizationBearer

A secret key (rl_sk_test_..., rl_sk_live_...) or a restricted key with limited scopes (rl_rk_test_..., rl_rk_live_...). A restricted key can carry agent: true and an expires_at, and is what a coding agent should hold. Keys end in a checksum so secret scanners can recognize them. People create, roll and revoke keys in the dashboard; GET /v1/api_keys lists them, masked.

Query parameters

limitintegerOptional1-100Defaults to 20

Maximum number of objects to return, from 1 to 100.

cursorstringOptional

The next_cursor from the previous page.

customerstringOptional

Only limits that apply to this customer (cus_...).

planstringOptional

Only limits for this plan (ID or key).

agent_idstringOptional

member_idstringOptional

team_idstringOptional

set_byenumOptionalDefaults to operator

operator: you set it as policy. customer: your customer chose it, through your product or the customer view.

Allowed values:

enabledbooleanOptional

Only limits that are on (true) or off (false).

Response

A page of spend limits.

object"list"

datalist of objects

has_moreboolean

next_cursorstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error