Skip to main content

​
Create a customer

curl -X POST https://api.ledger.so/v1/customers \
  -H "Authorization: Bearer $LEDGER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: create-cust-1" \
  -d '{
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Doe",
    "type": "individual"
  }'
When you create a customer, Ledger initiates verification behind the scenes and provides a hosted KYC link.

​
KYC lifecycle

  1. Create the customer via POST /v1/customers
  2. Customer completes KYC via the hosted link
  3. Once approved, capabilities unlock based on verification level
  4. You can now create wallets, cards, and accounts

​
Key fields to watch

FieldValues
kycStatusnot_started, under_review, incomplete, approved, rejected
capabilitiescards, wallets, virtualAccounts, transfers
statuspending, active, suspended, rejected

​
Listing customers

curl -sS "https://api.ledger.so/v1/customers?limit=10" \
  -H "Authorization: Bearer $LEDGER_API_KEY"