Documentation

Billing API

Live endpoints for credit balance, top-ups, wallet ledger, and invoices.

Base URL: https://sentinel-api.fortiqo.xyz

All billing endpoints require an authenticated session — see authentication.

Get balance

GET /v1/billing/balance

Returns your current credit balance.

curl -b cookies.txt https://sentinel-api.fortiqo.xyz/v1/billing/balance

Top up credits

POST /v1/billing/topup

Adds credits to your wallet.

curl -b cookies.txt -X POST \
  https://sentinel-api.fortiqo.xyz/v1/billing/topup \
  -H "Content-Type: application/json" \
  -d '{"amountPaise": 50000, "currency": "INR"}'

Field	Type	Description
`amountPaise`	integer	Amount in minor units (paise — ₹1 = 100 paise)
`currency`	string	ISO currency code, e.g. `INR`

Warning

Top-ups charge real money once payment providers are live. Amounts are always integers in minor units — never send fractional values.

Wallet ledger

GET /v1/billing/ledger

Returns your wallet ledger — every credit and debit on your account, including charges for agent invocations and top-ups.

curl -b cookies.txt https://sentinel-api.fortiqo.xyz/v1/billing/ledger

Invoices

GET /v1/billing/invoices

Lists your top-up invoices.

How charging works

Invocations debit your wallet per the agent's listed price.
Pass max_cost_credits on invoke or chat requests to set a hard ceiling per call.
Pass an idempotency_key on invocations so retries are never double-charged.
You are only charged for successful calls — failed invocations do not debit your wallet.

Note

Developer payouts, settlement history, and hosting-fee endpoints are part of the settlement rollout and will be documented here when they reach the live API.