GET/api/orgs/{org_id}/pending-holds

List pending credit holds

A hold is a reservation kept for a request whose final provider usage is not yet known (for example a cancelled call), so it may not appear in the usage log yet. Holds reduce available credit but are not spend. Amounts are integer nano-USD (1 USD = 1,000,000,000).

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

パスパラメータ

  • org_idstring必須

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

クエリパラメータ

  • limitinteger

    Page size.

    デフォルト: 50
  • beforestring

    The next_cursor from the previous page.

レスポンス

  • 200

    One page of pending holds plus current availability.

    レスポンス
    • itemsarray<object>必須
      items
      • attempt_idstring必須
      • request_idstring必須

        The request id (x-request-id) of the call holding credit.

      • created_atstring必須
      • stateenum必須
        "pending"
      • pending_nano_usdinteger必須

        Amount still held, integer nano-USD.

      • authorized_nano_usdinteger必須

        Amount reserved at admission, integer nano-USD.

      • charged_nano_usdinteger必須

        Amount already charged, integer nano-USD.

      • promo_fundedboolean必須

        True when a free promotion funds the call.

      • usage_sourcestring必須

        How the attempt's usage was known when it was held (observed or unknown).

      • input_tokensinteger | null必須
      • output_tokensinteger | null必須
    • next_cursorstring | null必須

      Pass as before for the next page; null on the last page.

    • availabilityobject必須
      availability
      • credit_balance_nano_usdinteger必須

        Granted minus settled spend, integer nano-USD.

      • pending_nano_usdinteger必須

        Total of all pending holds, integer nano-USD.

      • available_nano_usdinteger必須

        Balance minus holds, integer nano-USD.

  • 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).

  • 404

    The resource does not exist or belongs to another 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

    The body or query failed validation.

    レスポンス
    • detailarray<object>必須
      detail
      • typestring
      • locarray<string | integer>
      • msgstring

リクエスト

curl https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/pending-holds?limit=50&before=att_01JD8K2QW7R4N6X9V3B5M1C0ZP \
  -H "Authorization: Bearer YOUR_API_KEY"

レスポンス

{
  "items": [
    {
      "attempt_id": "att_01JD8K2QW7R4N6X9V3B5M1C0ZP",
      "request_id": "req_01JD8K2Q9F2T7Y4H6K8M0N3P5R",
      "created_at": "2026-11-19T08:15:42.118Z",
      "state": "pending",
      "pending_nano_usd": 184000000,
      "authorized_nano_usd": 184000000,
      "charged_nano_usd": 0,
      "promo_funded": false,
      "usage_source": "unknown",
      "input_tokens": 41230,
      "output_tokens": null
    }
  ],
  "next_cursor": null,
  "availability": {
    "credit_balance_nano_usd": 42500000000,
    "pending_nano_usd": 184000000,
    "available_nano_usd": 42316000000
  }
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/pending-holds?limit=50&before=att_01JD8K2QW7R4N6X9V3B5M1C0ZP