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.

認証: AuthorizationヘッダーにBearer形式のAPIキー

パスパラメータ

  • org_idstring必須

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

クエリパラメータ

  • periodstring必須

    Month to meter, YYYY-MM.

レスポンス

  • 200

    Budgets.

    レスポンス
    • budgetsarray<object>必須
      budgets
      • budget_idstring必須
      • periodstring必須

        YYYY-MM, or * for recurring.

      • scope_kindenum必須
        "team""identity""key""model""pool""deployment"
      • api_key_idstring | null必須
      • identity_idstring | null必須
      • alias_idstring | null必須
      • pool_idstring | null必須
      • deployment_idstring | null必須
      • limit_nano_usdinteger必須

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

      • reserved_nano_usdinteger必須

        In flight, integer nano-USD.

      • settled_nano_usdinteger必須

        Spent this month, integer nano-USD.

      • remaining_nano_usdinteger必須

        Integer nano-USD.

      • created_by_kindenum必須
        "session""api_key"
      • created_by_api_key_idstring | null必須

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

  • 401

    Missing, unknown or revoked API key.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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.

    レスポンス
    • errorstring必須

      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.

リクエスト

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

レスポンス

{
  "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