Skip to content
Developers
Get started
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Get the prepaid wallet

GET
/api/v1/billing/wallet
curl --request GET \
--url https://api.pitch2sale.com/api/v1/billing/wallet \
--header 'Authorization: Bearer <token>'

Balance (minor units of the wallet currency, which is the billing currency), the top-up packs with GST for INR, the wallet rates in the wallet currency (INR = USD rate × platform FX × 1.05), and per wallet meter this period’s allowance, wallet-paid units, safety cap and wallet spend, plus banner flags (wallet_empty, allowance_exhausted, safety_cap_reached, calls_paused). Each rate carries counted (how it is counted, e.g. calls: “30 s minimum per connected call, then 10 s steps”; AI voice agent: “per started minute”). Wallet credit does not expire. While calls_paused is true, new wallet-paid calls (calls, AI voice agent calls and live translation sessions; never SMS) answer 402 WALLET_PAUSED_MARGIN (actions contact_support, message “Calling from the wallet is paused. Contact support.”); plan minutes keep working. Owners and admins only (members 403).

OK

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing; OAuth app tokens are not accepted on this route

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}