GET/api/orgs/{org_id}/budgets

List budgets for a month

Provisioning key only. Every budget (all scopes, recurring ones included) with balances for period. Money is integer nano-USD.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

Query parameters

  • periodstringrequired

    Month to meter, YYYY-MM.

Responses

  • 200

    Budgets.

    Response
    • budgetsarray<object>required
      budgets
      • budget_idstringrequired
      • periodstringrequired

        YYYY-MM, or * for recurring.

      • scope_kindenumrequired
        "team""identity""key""model""pool""deployment"
      • api_key_idstring | nullrequired
      • identity_idstring | nullrequired
      • alias_idstring | nullrequired
      • pool_idstring | nullrequired
      • deployment_idstring | nullrequired
      • limit_nano_usdintegerrequired

        The cap, integer nano-USD. 0 is a hard zero cap.

      • reserved_nano_usdintegerrequired

        In flight, integer nano-USD.

      • settled_nano_usdintegerrequired

        Spent this month, integer nano-USD.

      • remaining_nano_usdintegerrequired

        Integer nano-USD.

      • created_by_kindenumrequired
        "session""api_key"
      • created_by_api_key_idstring | nullrequired

        The authoring key; a key may change only its own rows.

  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    The key is not a provisioning key (inference keys are refused, reads included), or it is a customer-plan key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    Unknown organization, or not the key's own organization.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 422

    Missing or malformed period.

Request

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets?period=2026-11 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "budgets": [
    {
      "budget_id": "b7e1c0d2-5a4f-4c39-8e16-2d9f0a7b3c51",
      "period": "*",
      "scope_kind": "identity",
      "api_key_id": null,
      "identity_id": "acme-support",
      "alias_id": null,
      "pool_id": null,
      "deployment_id": null,
      "limit_nano_usd": 50000000000,
      "reserved_nano_usd": 120000000,
      "settled_nano_usd": 18400000000,
      "remaining_nano_usd": 31480000000,
      "created_by_kind": "api_key",
      "created_by_api_key_id": "6b1d2f4e-3c8a-4f0e-9a21-7e5c0d9b4a33"
    }
  ]
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets?period=2026-11