# Get an Onramp Session

One of the user's sessions, as the payment provider sees it now.

## Overview

- While the session is not final, Aurea reads it again from the payment provider and applies the answer; its status only moves forward (see [Statuses](https://docs.aureahub.com/docs/guide-card-onramp.md)).
- While it is `initialized` or `requires_payment` the answer carries `clientSecret` and `publishableKey`, so the app can open the widget again where the user left it; otherwise both are `null`.
- Once `fulfillment_complete`, `transactionId` is the on-chain hash of the delivery and `amounts` what the payment provider charged and delivered, in `amounts.sourceCurrency` (the currency the payment provider charged in: the user can switch it in the widget).
- Answers whatever your tenant's settings: switching the onramp off stops new sessions, not the reading of existing ones. `404` `CARD_ONRAMP_SESSION_NOT_FOUND` for a session that is not the user's.

## Endpoint

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

Authentication: bearer token required.

One of the user's onramp sessions.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | yes | The session's `id` |

**Responses**

`200` Delivered

```json
{
  "session": {
    "id": "444417bc-0675-4d3a-8831-bd1cbedc9738",
    "environment": "sandbox",
    "status": "fulfillment_complete",
    "providerStatus": "fulfillment_complete",
    "providerSessionId": "cos_1QAbCdEfGhIjKlMn",
    "pair": {
      "name": "usdc/ethereum",
      "currency": "usdc",
      "network": "ethereum",
      "aureaChain": "ethereum",
      "family": "evm",
      "sourceCurrencies": ["eur", "usd"]
    },
    "destination": {
      "kind": "aurea_wallet",
      "walletId": "990b620f-a1f5-4317-9c77-974270328a92",
      "addressId": null,
      "address": "0xC0207704CaEB9342cf491Ad4a177F43592df65a7"
    },
    "customer": null,
    "requested": {
      "sourceCurrency": "eur",
      "sourceAmount": "50.00",
      "destinationAmount": null
    },
    "amounts": {
      "sourceCurrency": "eur",
      "sourceAmount": "50.00",
      "destinationAmount": "45.980000",
      "networkFee": "1.92",
      "transactionFee": "2.10"
    },
    "transactionId": "0x5c0e9b2f3a1d4c6e8f7a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e",
    "failureCode": null,
    "createdAt": "2026-09-24T14:30:00.274Z",
    "updatedAt": "2026-09-24T14:30:00.333Z"
  },
  "clientSecret": null,
  "publishableKey": null
}
```

---

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