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

# Get voucher

> Retrieve a single voucher by its public code.

**Required scope:** `vouchers:read`
**Rate limit:** 300 requests/minute

## Path parameters

| Parameter | Type   | Notes                           |
| --------- | ------ | ------------------------------- |
| `code`    | string | Voucher code, max 50 characters |

## Query parameters

| Parameter | Type   | Notes                                                 |
| --------- | ------ | ----------------------------------------------------- |
| `include` | string | Set to `customer` to embed the linked customer record |

## Response

```json theme={null}
{
  "id": "8d82f0d2-7f94-4a3b-8b55-1e2e3a4f5b6c",
  "code": "VG-EXAMPLE1",
  "amount": "100.00",
  "balance": "75.00",
  "status": "completed",
  "recipient_name": "Sam Recipient",
  "recipient_email": "sam@example.com",
  "expiry_date": "2029-04-26T00:00:00Z",
  "created_at": "2026-04-26T01:23:45Z",
  "updated_at": "2026-04-26T01:23:45Z",
  "location_id": null
}
```

## Errors

* `404` – Voucher with that code does not exist in your tenant (or is at a
  different location than your location-scoped key).
* `422` – `include` is set to anything other than `customer`.

## Examples

```bash theme={null}
curl \
  -H "X-API-Key: vg_live_EXAMPLEdoNotUseThis123456" \
  "https://api.vouchergrid.com/api/v1/developer/vouchers/VG-EXAMPLE1?include=customer"
```

```ts theme={null}
const res = await fetch(
  "https://api.vouchergrid.com/api/v1/developer/vouchers/VG-EXAMPLE1?include=customer",
  { headers: { "X-API-Key": process.env.VOUCHERGRID_API_KEY! } },
);
const voucher = await res.json();
```