> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/billing/transactions — wallet transaction history

> List wallet transactions (top-ups, usage debits, adjustments) with cursor-based pagination. Amounts are signed and in the wallet currency.

List wallet transactions in reverse chronological order. Transactions include top-up credits, usage debits, and manual adjustments. Amounts are signed: credits are positive, debits are negative.

**Method:** `GET` **Path:** `/api/billing/transactions` **Auth:** Session Bearer

## Query parameters

<ParamField query="limit" type="number">
  Maximum number of transactions to return. Default `50`.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque cursor from a previous response's `next_cursor`.
</ParamField>

## Response

<ResponseField name="transactions" type="object[]">
  <Expandable title="transaction">
    <ResponseField name="id" type="string">
      Stable identifier.
    </ResponseField>

    <ResponseField name="type" type="string">
      `topup`, `usage`, or `adjustment`.
    </ResponseField>

    <ResponseField name="amount" type="number">
      Signed amount in `currency`.
    </ResponseField>

    <ResponseField name="currency" type="string">
      `USD` or `CNY`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp.
    </ResponseField>

    <ResponseField name="description" type="string">
      Short human-readable description.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Cursor for the next page, or `null` at the end.
</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  "https://ariacompute.com/api/billing/transactions?limit=20"
```

```json theme={null}
{
  "transactions": [
    {
      "id": "txn_01H...",
      "type": "usage",
      "amount": -0.12,
      "currency": "USD",
      "created_at": "2026-09-23T08:59:00Z",
      "description": "gemma-4-e2b-it_q4 inference"
    }
  ],
  "next_cursor": null
}
```


## Related topics

- [GET /api/billing/summary — wallet and recent activity](/api-reference/billing/summary.md)
- [GET /api/billing/wallet — current wallet balance](/api-reference/billing/wallet.md)
- [GET /api/billing/payments — list wallet top-ups](/api-reference/billing/payments-list.md)
- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [GET /api/billing/payments/{id} — get payment status](/api-reference/billing/payments-get.md)