> ## 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/payments — list wallet top-ups

> List wallet top-up payments with cursor pagination and an optional status filter. Payments belong to the current account and site.

List wallet top-up payments in reverse chronological order. Filter by status to find pending, paid, failed, or expired attempts.

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

## Query parameters

<ParamField query="limit" type="number">
  Maximum entries. Default `50`.
</ParamField>

<ParamField query="cursor" type="string">
  Opaque pagination cursor.
</ParamField>

<ParamField query="status" type="string">
  `pending`, `paid`, `failed`, or `expired`.
</ParamField>

## Response

<ResponseField name="payments" type="object[]">
  <Expandable title="payment">
    <ResponseField name="id" type="string">
      Payment identifier.
    </ResponseField>

    <ResponseField name="provider" type="string">
      `stripe`, `wechat`, or `alipay`.
    </ResponseField>

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

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

    <ResponseField name="status" type="string">
      Current status.
    </ResponseField>

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

    <ResponseField name="paid_at" type="string">
      ISO 8601 timestamp or `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Next-page cursor or `null`.
</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer eyJhbGciOi..." \
  "https://ariacompute.com/api/billing/payments?limit=10&status=paid"
```


## Related topics

- [POST /api/billing/payments — start a wallet top-up](/api-reference/billing/payments-create.md)
- [Prepaid wallet, top-ups, and usage billing](/concepts/wallet-billing.md)
- [GET /api/billing/transactions — wallet transaction history](/api-reference/billing/transactions.md)
- [GET /api/billing/payments/{id} — get payment status](/api-reference/billing/payments-get.md)
- [Top up your wallet with Stripe, WeChat Pay, or Alipay](/guides/top-up-wallet.md)