Get Balance | Mesh API Docs

Return the credit balance for the authenticated caller.

Authenticate with an rsk_ API key. If the key belongs to an organization, the organization’s shared balance is returned — all members of an org share the same billing pool; a key with no org gets its own balance. The response also reports how much of the balance is reserved by in-flight operations (reserved_usd, plus a per-category reserved_breakdown) and the spendable remainder (available_usd).

Return the credit balance for the authenticated caller. Authenticate with an rsk_ API key. If the key belongs to an organization, the organization's shared balance is returned — all members of an org share the same billing pool; a key with no org gets its own balance. The response also reports how much of the balance is reserved by in-flight operations (`reserved_usd`, plus a per-category `reserved_breakdown`) and the spendable remainder (`available_usd`).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful Response

balance_usdstring

Total credit balance in USD.

available_usdstring

Spendable balance: balance_usd minus reserved_usd.

reserved_usdstringDefaults to 0.0000000

Funds currently held by in-flight operations and not spendable.

updated_atstring or null

Last balance update (ISO 8601).

messagestring or null

1	{
2	"balance_usd": "42.5000000",
3	"available_usd": "27.5000000",
4	"reserved_usd": "15.0000000",
5	"updated_at": "2026-07-14T10:15:30+00:00",
6	"message": null,
7	"reserved_breakdown": [
8	{
9	"kind": "realtime",
10	"reserved_usd": "5.0000000"
11	},
12	{
13	"kind": "video",
14	"reserved_usd": "10.0000000"
15	}
16	]
17	}