Wallet ledger activity
Alpha
GET
https://api.voxrouter.ai/v1/credits/activityReturn recent entries from the wallet ledger for the authenticated key's account, newest first. Each entry records a wallet mutation (top-up, reservation, commit, refund) with the signed `microsDelta` applied, the resulting `microsBalanceAfter`, and the `source` and `metadata` describing the cause. Keys without an associated account return an empty list.
bash
curl https://api.voxrouter.ai/v1/credits/activity \
-H "Authorization: Bearer $VOXROUTER_API_KEY"Headers
AuthorizationstringRequiredBearer token. Send as
Authorization: Bearer pk_....Query parameters
limitintegerOptionalDefaults to 50Maximum number of rows to return (1-100).
Response
Ledger entries, newest first.
json
{
"rows": [
{
"id": "string",
"kind": "string",
"microsDelta": 0,
"microsBalanceAfter": 0,
"reservationId": "string",
"source": "string",
"metadata": null,
"createdAt": "string"
}
]
}rowsobject[]RequiredErrors
Non-2xx responses return a JSON body with a machine-readable error code and an optional details string.
| Status | Meaning |
|---|---|
| 400 | Request body failed validation or model string is malformed. |
| 401 | Missing or invalid API key. |
| 429 | Per-key rate limit or per-key concurrency limit exceeded. The `code` field on the body distinguishes the two (`rate_limit_exceeded` vs `concurrency_limit_exceeded`). `Retry-After` is seconds-from-now: a hard value until the rate-limit window resets, or a soft `1` hint for concurrency (slots free on request completion). |
| 500 | Unexpected server error. |