Quickstart - Ledger

Base URL

All API requests are made to:

https://api.ledger.so/v1

Set up

export LEDGER_API_KEY="ld_test_..."

Health check

curl -sS https://api.ledger.so/v1/health

Create a customer

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.