Customers Management

Use these endpoints to create customers, retrieve their details, manage KYC documents and status, and handle tier upgrades and verification.

When to use this API

Typical flows:

• Onboard a new customer and store their core details.
• Attach and review KYC documents for a customer.
• Check KYC status before enabling sensitive features.
• Request Tier 2 / Tier 3 upgrades and verify identities.

Core customer operations

• List or search customers – GET /customers
• Create customer – POST /customers
• Get customer by ID – GET /customers/{customerId}

KYC & tiers

• Get customer KYC documents – GET /customers/{customerId}/kyc/documents
• Get customer KYC status – GET /customers/{customerId}/kyc/status
• Request Tier 2 upgrade – POST /customers/{customerId}/kyc/tier2/request
• Request Tier 3 upgrade – POST /customers/{customerId}/kyc/tier3/request

Verification

• Verify customer – POST /customers/verify

Environment & access

• These endpoints usually require KYC/KYB approval before you can move customers to higher tiers.
• Some verification flows may be limited in sandbox vs. production.

See also

• Getting Started: /docs
• Accounts Management: /docs/accounts-management