Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Get Organization Balance

Requires an admin API key with billing_read or * authority. Returns the authenticated organization’s spendable credits across all projects. Pending reservations, expired funding, and refunds are excluded. The decimal string preserves up to three fractional digits. This is a snapshot and may change after the response. The organization’s request-rate limit applies and may return 429.

GET/v1/organization/balance
Authorization
AuthorizationBearer token · headerrequired

Authentication via Bearer token API key

Responses
200

Spendable organization credit balance

objectstringrequired
Allowed:organization.balance
organization_idstringrequired
available_creditsstringrequired
matches ^\d+(?:\.\d{1,3})?$
observed_atintegerrequired
min 0
401

Unauthorized – missing, malformed, disabled, or invalid API credentials or organization identity.

codestringrequired
Allowed:invalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailable
messagestringrequired
min length 1
paramstring

The request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.

min length 1 · max length 128
request_idstringrequired
min length 1
retry_afterinteger
min 0 · max 86400
statusintegerrequired
min 400 · max 599
403

Forbidden – the credential lacks admin billing_read authority or the organization is suspended.

codestringrequired
Allowed:invalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailable
messagestringrequired
min length 1
paramstring

The request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.

min length 1 · max length 128
request_idstringrequired
min length 1
retry_afterinteger
min 0 · max 86400
statusintegerrequired
min 400 · max 599
429

Rate limit exceeded – the organization's request-rate ceiling was reached. Retry after the period indicated by Retry-After.

codestringrequired
Allowed:invalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailable
messagestringrequired
min length 1
paramstring

The request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.

min length 1 · max length 128
request_idstringrequired
min length 1
retry_afterinteger
min 0 · max 86400
statusintegerrequired
min 400 · max 599
500

The organization balance could not be read. Please retry.

codestringrequired
Allowed:invalid_requestinvalid_api_keyunauthorizedfunding_payment_failedfunding_payment_method_requiredfunding_payment_action_requiredfunding_pendinginsufficient_creditsaccount_frozencontent_policy_violationmodel_not_foundpayload_too_largerequest_timeoutrate_limit_exceededoperation_rate_limit_exceededweekly_limit_exceededserver_errormodel_errormodel_unavailable
messagestringrequired
min length 1
paramstring

The request parameter the failure is about, as a path from the request body root: size.width, input[0].content. A parameter name, never a submitted value. The same field, with the same meaning, as param on the Open Responses error payload, so one name reads across a failure raised before streaming and one raised during it. Absent, rather than null, when the failure is not about one particular parameter.

min length 1 · max length 128
request_idstringrequired
min length 1
retry_afterinteger
min 0 · max 86400
statusintegerrequired
min 400 · max 599
Try it
Server
Authorization
Request
curl -X GET "https://api.quiver.ai/v1/organization/balance" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "object": "organization.balance",
  "organization_id": "org_example",
  "available_credits": "1234.567",
  "observed_at": 1780000000
}