Skip to main content

​
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.