> ## 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 customer

> Retrieve a single customer record.

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

## Path parameters

| Parameter     | Type | Notes               |
| ------------- | ---- | ------------------- |
| `customer_id` | UUID | Customer identifier |

## Response

```json theme={null}
{
  "id": "c0ffee00-0000-4000-8000-000000000001",
  "email": "buyer@example.com",
  "first_name": "Alex",
  "last_name": "Buyer",
  "total_ltv": "175.00",
  "created_at": "2026-04-26T01:23:45Z",
  "location_id": null
}
```

## Errors

* `404` – Customer not found in your tenant.

## Examples

```bash theme={null}
curl \
  -H "X-API-Key: vg_live_EXAMPLEdoNotUseThis123456" \
  "https://api.vouchergrid.com/api/v1/developer/customers/c0ffee00-0000-4000-8000-000000000001"
```

```ts theme={null}
const res = await fetch(
  "https://api.vouchergrid.com/api/v1/developer/customers/c0ffee00-0000-4000-8000-000000000001",
  { headers: { "X-API-Key": process.env.VOUCHERGRID_API_KEY! } },
);
const customer = await res.json();
```