# Get a Purchase

One of the end user's purchases as it stands now.

## Overview

- Read again from the payment provider while it is not final; its status only moves forward.
- While it is initialized or requires_payment, the answer carries the client secret again.
- `404` `CARD_ONRAMP_SESSION_NOT_FOUND` for a purchase that is not this end user's.

## Endpoint

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

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

Reads one purchase.

**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 |
| `id` | string (uuid) | yes | The session id |

**Responses**

`200` OK

```json
{
  "session": {
    "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"
  },
  "clientSecret": "cos_test000001_secret_standin1",
  "publishableKey": "pk_test_51StandInPublishable0000"
}
```

---

Web version: https://docs.aureahub.com/#card-wallets-session-get