Get Billing Account

GET /api/v1/billing/account

Snapshot of your organization's billing account (billing mode, balance, credit limit).

Auth: this endpoint belongs to the console backend API (base URL https://portal.aiin1.ai — note, not api.portal.aiin1.ai). It requires an access_token obtained by logging in with a console account (valid 15 minutes); the sk-nex- API token does not work here. See Billing Reconciliation & Automated Usage Sync for the login flow. For balance monitoring alone, prefer the zero-login token query GET https://api.portal.aiin1.ai/v1/dashboard/billing/credit_grants with your sk-nex- token — covered in the same guide.

Example

curl https://portal.aiin1.ai/api/v1/billing/account \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

Field	Type	Required	Description
`id`	string(uuid)	yes	Billing account ID
`org_id`	string(uuid)	yes	Organization ID
`billing_mode`	string	yes	Billing mode: `prepaid` / `postpaid` / `hybrid`
`credit_balance_usd`	string(decimal)	yes	Real-time available balance (USD; source of truth for prepaid, meaningless for postpaid / hybrid)
`credit_limit_usd`	string(decimal)	yes	Credit limit (USD; used by postpaid / hybrid)
`updated_at`	string(datetime)	yes	Updated at