# List Purchases

The end user's purchases in one environment, newest first.

## Overview

- As stored: the payment provider is not asked, and no client secret is answered. Read one purchase to refresh it.

## Endpoint

### `GET /v1/ramp/card/customers/{externalId}/sessions`

Authentication: signed by the tenant's server — headers `x-tenant-api-key`, `x-timestamp`, `x-signature` (see Authentication → Tenant signature). No user token.

Lists the end user's purchases.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `externalId` | string | yes | Your own id of the end user, 1 to 100 characters: letters, digits, dot, underscore, colon, at sign or hyphen |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | true for the sandbox |
| `limit` | integer | no | 1 to 100, 20 by default |
| `offset` | integer | no | 0 by default |

**Responses**

`200` OK

```json
{
  "sessions": [
    {
      "id": "1a9f1da0-40b0-4b90-b33c-ddf9d31922d1",
      "environment": "sandbox",
      "status": "initialized",
      "providerStatus": "initialized",
      "providerSessionId": "cos_test000001",
      "pair": {
        "name": "usdc/base",
        "currency": "usdc",
        "network": "base",
        "aureaChain": "base",
        "family": "evm",
        "sourceCurrencies": ["usd"]
      },
      "destination": {
        "kind": "tenant_wallet",
        "walletId": null,
        "addressId": null,
        "address": "0x2f8C1e4d6B3A9E0F7C5D2B1A8E6f4c3d0b9A7E51"
      },
      "customer": {
        "externalId": "user_8421"
      },
      "requested": {
        "sourceCurrency": "usd",
        "sourceAmount": "50.00",
        "destinationAmount": null
      },
      "amounts": {
        "sourceCurrency": "usd",
        "sourceAmount": "50.00",
        "destinationAmount": null,
        "networkFee": null,
        "transactionFee": null
      },
      "transactionId": null,
      "failureCode": null,
      "createdAt": "2026-09-25T01:46:56.634Z",
      "updatedAt": "2026-09-25T01:46:56.679Z"
    }
  ],
  "total": 1
}
```

---

Web version: https://docs.aureahub.com/#card-wallets-sessions-list
