Spend Limits

List spend limits

Changed on

Returns one entry per product and period you can set a limit on, with the limit, the spend so far in the period and whether the product is blocked. An entry without a limit is still listed (limit: null). When the spend cannot be read, the entry is returned with spend_usd: null and spend_error set. The list is not paginated. Each entry also lists the API key limits of its product and period in credential_limits, with each key's spend and block, and in allocation how much of the total limit they use.

get/spend_limits

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/spend_limits
  • Auth
    HTTP bearer

Response

Spend limits, spend and blocks per product and period.

Example response

{
  "data": [
    {
      "record_type": "spend_limit",
      "product": "inference",
      "product_name": "Inference",
      "period": "daily",
      "period_start": "2026-09-24",
      "period_end": "2026-09-25",
      "limit": {
        "amount": "100",
        "origin": "self_service",
        "updated_at": "2026-09-24T09:12:03.412Z"
      },
      "effective_limit_usd": "100",
      "spend_usd": "37.41",
      "block": {
        "detected_at": "2026-09-24T08:41:17Z",
        "spend_usd": "10.20",
        "limit_usd": "10",
        "blocked_until": "2026-09-25"
      },
      "allocation": {
        "total_limit_usd": "1000.00",
        "allocated_usd": "800.00",
        "unallocated_usd": "200.00",
        "over_allocated_usd": "0.00"
      },
      "credential_limits": [
        {
          "credential_id": "KEY0192F3A1B2C3D4E5F6A7B8C9D0E1F2",
          "limit": {
            "amount": "300.00",
            "origin": "self_service",
            "updated_at": "2026-10-20T08:03:40Z"
          },
          "spend_usd": "120.00",
          "block": {
            "detected_at": "2026-09-24T08:41:17Z",
            "spend_usd": "10.20",
            "limit_usd": "10",
            "blocked_until": "2026-09-25"
          }
        }
      ],
      "evaluation": {
        "spend_usd": "37.41",
        "note": "A block was lifted by Telnyx support today; this limit applies from tomorrow."
      }
    }
  ],
  "meta": {
    "total_pages": 1,
    "total_results": 2,
    "page_number": 1,
    "page_size": 2
  }
}

Changes

  • 4de6bba1c49dRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

  • a72569d69430Revision changes
    • info

      endpoint added