Skip to content
API Reference
/
Cloud Phones
/
/Account & Quotas

Account & Quotas

Query wallet balance and Cloud Phone usage quotas.

Operations

Get Account Balance and Cloud Phone Quotas

Request

Returns the authenticated team's available wallet balance, remaining Cloud Phone duration, and remaining team concurrency.

The caller must be the team owner or have a cost-related permission. Business errors include 99012 (no cost permission), 20029 (wallet account unavailable), and 20032 (balance query failed).

GET
/api/balance
curl -i -X GET \
  http://127.0.0.1:40000/api/balance

Responses

Request processed; inspect code for the business result

Bodyapplication/json
codeintegerrequired

Business result code; 0 indicates success

Example:0
msgstring or nullrequired

Error message; null when successful

Example:null
requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"
dataobjectrequired
Response
{
  "code": 0,
  "msg": null,
  "data": {
    "balance": 12500,
    "remainingDuration": "120",
    "remainingConcurrency": 3
  },
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}