Get Hosted Customer by ID

get

https://example.com

Retrieve a hosted onboarding customer's current information and KYB verification status.

This is the primary endpoint for polling KYB progress after the end user has been redirected to the hosted onboarding page. Call this endpoint periodically (recommended: every 30–60 seconds) until the status reaches a terminal state (APPROVED or REJECTED).

KYB Status Lifecycle

INIT → PENDING_REVIEW → UNDER_REVIEW → APPROVED
                                      → REJECTED
                                      → PENDING_RESPONSE → PENDING_REVIEW (resubmit)

Status Values

Status	Description	Action Required
`INIT`	Customer created, onboarding not started or in progress	Wait for user to complete the hosted form
`PENDING_REVIEW`	KYB submitted by the user, queued for compliance review	No action required
`UNDER_REVIEW`	Compliance team is actively reviewing the application	No action required
`PENDING_RESPONSE`	Additional information or corrections needed from the user	Create a new onboarding grant to let the user return and update their application
`REJECTED`	KYB application rejected	Contact 1money support for details
`APPROVED`	KYB verification complete, customer is fully onboarded	Customer is ready for transactions

Re-entry for PENDING_RESPONSE

When the status is PENDING_RESPONSE, the compliance team has flagged items that need correction. To allow the user to fix them:

Call POST /v1/customers/onboarding/grants with the same customer_id
Redirect the user to the new onboarding_url
The user's previous progress is preserved; they only need to update the flagged items

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…