/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).
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.
Query parameters
limitintegerPage size.
beforestringThe
next_cursorfrom the previous page.
Responses
200One page of pending holds plus current availability.
Response
itemsarray<object>requireditems
attempt_idstringrequiredrequest_idstringrequiredThe request id (
x-request-id) of the call holding credit.created_atstringrequiredstateenumrequiredpending_nano_usdintegerrequiredAmount still held, integer nano-USD.
authorized_nano_usdintegerrequiredAmount reserved at admission, integer nano-USD.
charged_nano_usdintegerrequiredAmount already charged, integer nano-USD.
promo_fundedbooleanrequiredTrue when a free promotion funds the call.
usage_sourcestringrequiredHow the attempt's usage was known when it was held (
observedorunknown).input_tokensinteger | nullrequiredoutput_tokensinteger | nullrequired
next_cursorstring | nullrequiredPass as
beforefor the next page; null on the last page.availabilityobjectrequiredavailability
credit_balance_nano_usdintegerrequiredGranted minus settled spend, integer nano-USD.
pending_nano_usdintegerrequiredTotal of all pending holds, integer nano-USD.
available_nano_usdintegerrequiredBalance minus holds, integer nano-USD.
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-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.
Response
errorstringrequiredHuman-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.
Response
detailarray<object>requireddetail
typestringlocarray<string | integer>msgstring
Request
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"Response
{
"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