Get account balance | Saperly Docs

Returns the current account balance. The credits field carries US cents (the field-name rename to balance_cents is deferred to v0.6.x for backward compatibility; values are cents-honest as of v0.5.2.0).

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Response

Account balance

creditsinteger

Current balance in US cents (e.g. 500 = $5.00)

currencystring

Currency code. Servers >= v0.5.3 return “USD”; older servers (v0.5.2.x and before) returned the literal “credits” — clients should treat any non-”USD” value as legacy.

Errors

401

Unauthorized Error

404

Not Found Error

1	const url = 'https://saperly.com/api/v1/billing/balance';
2	const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
3
4	try {
5	const response = await fetch(url, options);
6	const data = await response.json();
7	console.log(data);
8	} catch (error) {
9	console.error(error);
10	}