Search docs

Find any page, endpoint, or guide.

Wallet ledger activity

Alpha
GEThttps://api.voxrouter.ai/v1/credits/activity

Return 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

AuthorizationstringRequired
Bearer token. Send as Authorization: Bearer pk_....

Query parameters

limitintegerOptionalDefaults to 50
Maximum 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[]Required

Errors

Non-2xx responses return a JSON body with a machine-readable error code and an optional details string.

StatusMeaning
400Request body failed validation or model string is malformed.
401Missing or invalid API key.
429Per-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).
500Unexpected server error.