GuidesAPI ReferenceChangelog
API Reference

Get Customer

Retrieve detailed information about a specific Customer, including current KYB verification status.

This endpoint serves both the full API onboarding and hosted onboarding flows.

Use Cases

  • Full API flow: Retrieve customer details and KYB data after submitting via POST /v1/customers
  • Hosted onboarding: Poll KYB verification progress after redirecting the user via an onboarding grant
  • Display customer information in your application

KYB Status Values

StatusDescription
initInitial state, data incomplete
pending_reviewData complete, queued for compliance review
under_reviewBeing reviewed by compliance
pending_responseAdditional information requested
escalatedEscalated for further review
pending_approvalPending final approval
rejectedApplication rejected
approvedKYB approved, customer active
provisioningKYB approved, fiat accounts being set up

Re-entry for pending_response (Hosted Onboarding)

When the status is pending_response, the compliance team has flagged items that need correction:

  1. Call POST /v1/customers/onboarding/grants with the same customer_id
  2. Redirect the user to the new onboarding_url
  3. The user's previous progress is preserved; they only need to update the flagged items
Language
Credentials
Bearer
OneMoney-HMAC-SHA256
Response
Click Try It! to start a request and see the response here!