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

# Quickstart

> Make your first requests to the Ledger API (v1).

## Base URL

All API requests are made to:

```
https://api.ledger.so/v1
```

## Set up

```bash theme={null}
export LEDGER_API_KEY="ld_test_..."
```

## Health check

```bash theme={null}
curl -sS https://api.ledger.so/v1/health
```

## Create a customer

```bash theme={null}
curl -sS https://api.ledger.so/v1/customers \
  -H "Authorization: Bearer $LEDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-customer-$(uuidgen)" \
  -d '{
    "email": "dev@example.com",
    "firstName": "Dev",
    "lastName": "Example",
    "type": "individual"
  }'
```

Reuse the same `Idempotency-Key` only when you want the same response back for a safe retry. A new customer create should use a new key.