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

# Get eSIM Top-Up

> Retrieve an eSIM top-up by its PayVessel ID

Retrieve a top-up created by your business.

## Usage

```bash theme={null}
curl https://api.payvessel.com/vaas/api/v1/esim/topups/{topup_id} \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_SECRET_KEY"
```

## Response fields

| Field | Type | Description |
| - | - | - |
| `id` | string (uuid) | PayVessel top-up ID |
| `reference` | string | Your merchant reference |
| `package_code` | string | Applied top-up package code |
| `target_iccid` | string | ICCID of the eSIM that was topped up |
| `target_esim_tran_no` | string or null | Provider eSIM transaction number |
| `provider_topup_esim_tran_no` | string or null | Provider top-up transaction number |
| `amount_usd` | number | Amount in USD |
| `amount_naira` | number | Amount debited in NGN |
| `status` | string | `pending`, `success`, or `failed` |
| `error_message` | string or null | Error details when the top-up failed |

<Card title="API Reference" icon="code" href="/api-reference/esim/get-topup">
  Full request/response details and Try it
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.