API reference / Account

Wallet balance

Your current prepaid wallet balance.

GET/v1/wallet
Authentication
Bearer token
Scope
Any valid key

Before you integrate

  • This reply is not wrapped in the usual request_id and result envelope; the fields are at the top level.
  • Any valid API key can call this route.

Sample code

Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.

curl -sS -X GET 'https://grappi.ai/v1/wallet' \
  -H "Authorization: Bearer $GRAPPI_API_KEY"

Sample response

{
  "tenant_id": "ten_0123456789abcdef0123456789abcdef",
  "balance_minor": 49000,
  "currency": "INR"
}

Response fields

FieldTypeDescription
tenant_idstringYour account id.
balance_minorintegerWallet balance in paise, so 49000 means Rs 490.00.
currencystringCurrency of the balance; INR.

Errors

Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.