GET/api/orgs/{org_id}/identities/{identity_id}/customer-plan

Get an identity's customer plan

Any key may read its own identity (another identity answers 404). A provisioning key (not plan-bound) may read any identity in its organization. Returns null when no plan is assigned.

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

パスパラメータ

  • org_idstring必須

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

  • identity_idstring必須

    Identity id.

レスポンス

  • 200

    The assignment, or 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/customer-plan \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

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

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