/api/orgs/{org_id}/pending-holdsList 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/whoamireturns it.
クエリパラメータ
limitintegerPage size.
beforestringThe
next_cursorfrom the previous page.
レスポンス
200One 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_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 (
observedorunknown).input_tokensinteger | null必須output_tokensinteger | null必須
next_cursorstring | null必須Pass as
beforefor 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.
401Missing, unknown or revoked API key.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404The resource does not exist or belongs to another organization.
レスポンス
errorstring必須Human-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422The body or query failed validation.
レスポンス
detailarray<object>必須detail
typestringlocarray<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