GET/v1/balance

Account balance

Total of unpaid invoices (acc_balance) and the credit balance (acc_credit).

API v1 · Updated 2026-10-21View .md

Call it through the gateway https://api.tino.vn/v1 with a token that has the billing:read scope; see Calling the Tino API.

Authentication

Send the token in the header Authorization:

Authorization: Bearer <token>

Tokens that can call it: app tokens (tinoat_, Sign in with Tino) or personal API tokens (tinopat_).

Scopes

billing:readView invoices and payments

Parameters

This route takes no parameters.

Response

The route's JSON answer, in the same shape as UserAPI returns it (Personal data). Live sample from a test account with personal data masked; long arrays and strings are trimmed (… N more item(s), … N more line(s)).

Error codes

Error code	Description
`401 · invalid_token`	The token is wrong, expired or revoked.
`403 · insufficient_scope`	The token lacks the billing:read scope.
`403 · ip_not_allowed`	A personal API token called from an IP outside its allow-list.

Business errors of a route usually come as HTTP 200 with {"error": ["<code>"]}; see common error codes.