GET/api/orgs/{org_id}/identities/{identity_id}/allowances

Get an identity's plan allowances

Any key may read its own identity (another identity answers 404). A provisioning key (not plan-bound) may read any identity in its organization. Counters are the ones admission enforces, at frozen list value, integer nano-USD (with exact decimal strings).

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

パスパラメータ

  • org_idstring必須

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

  • identity_idstring必須

    Identity id.

レスポンス

  • 200

    Allowances.

    レスポンス
    • identity_idstring必須
    • assignmentobject | null必須
      いずれか

      object

      • org_idstring必須
      • identity_idstring必須
      • revisioninteger必須

        Pass as expected_revision on the next PUT.

      • plan_keystring | null必須
      • plan_versioninteger | null必須
      • pending_plan_keystring | null必須
      • pending_plan_versioninteger | null必須
      • pending_effective_atstring | null必須
      • updated_atstring必須
      • budget_periodobject
        いずれか

        object

        • kindstring必須

        object

        • kindstring必須
        • source_period_idstring必須
        • startstring必須
        • endstring必須
    • pricing_basisstring必須
    • period_startstring必須
    • period_endstring必須
    • groupsarray<object>必須
      groups
      • group_keystring必須
      • limit_nano_usdinteger必須

        Integer nano-USD.

      • settled_nano_usdinteger必須

        Integer nano-USD.

      • reserved_nano_usdinteger必須

        In flight, integer nano-USD.

      • pending_nano_usdinteger必須

        Integer nano-USD.

      • remaining_nano_usdinteger必須

        Integer nano-USD.

      • exactobject必須

        The same counters as decimal strings, for clients whose JSON numbers are floats.

        exact
        • settled_nano_usdstring必須
        • reserved_nano_usdstring必須
        • pending_nano_usdstring必須
        • remaining_nano_usdstring | null必須
    • budget_periodobject
      いずれか

      object

      • kindstring必須

      object

      • kindstring必須
      • source_period_idstring必須
      • startstring必須
      • endstring必須
    • aggregateobject | null
      いずれか

      object

      • limit_nano_usdinteger | null必須
      • settled_nano_usdinteger必須

        Integer nano-USD.

      • reserved_nano_usdinteger必須

        In flight, integer nano-USD.

      • pending_nano_usdinteger必須

        Integer nano-USD.

      • remaining_nano_usdinteger | null必須
      • exactobject必須

        The same counters as decimal strings, for clients whose JSON numbers are floats.

        exact
        • settled_nano_usdstring必須
        • reserved_nano_usdstring必須
        • pending_nano_usdstring必須
        • remaining_nano_usdstring | null必須
  • 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

    Not authorized for this policy change, or 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, identity or plan.

    レスポンス
    • 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).

  • 409

    Stale expected_revision, or customer-plan enforcement is off on this deployment.

    レスポンス
    • 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).

リクエスト

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/identities/acme-support/allowances \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "identity_id": "acme-support",
  "assignment": {
    "org_id": "3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10",
    "identity_id": "acme-support",
    "revision": 3,
    "plan_key": "starter",
    "plan_version": 2,
    "pending_plan_key": null,
    "pending_plan_version": null,
    "pending_effective_at": null,
    "updated_at": "2026-11-10T16:00:00Z",
    "budget_period": {
      "kind": "calendar_month_utc"
    }
  },
  "pricing_basis": "frozen_list_value",
  "period_start": "2026-11-01T00:00:00Z",
  "period_end": "2026-12-01T00:00:00Z",
  "groups": [
    {
      "group_key": "fast-models",
      "limit_nano_usd": 20000000000,
      "settled_nano_usd": 6400000000,
      "reserved_nano_usd": 40000000,
      "pending_nano_usd": 0,
      "remaining_nano_usd": 13560000000,
      "exact": {
        "settled_nano_usd": "6400000000",
        "reserved_nano_usd": "40000000",
        "pending_nano_usd": "0",
        "remaining_nano_usd": "13560000000"
      }
    }
  ],
  "budget_period": {
    "kind": "calendar_month_utc"
  },
  "aggregate": null
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/identities/acme-support/allowances