KYB

KYB Account Status

Changed on

Retrieves the KYB verification status of a business user for each product role: sender (the party funding an order) and recipient (the party being paid). Each role block holds the individual KYB tiers, or null when the user holds no KYB record for that role. For the account-wide verdict and rejection labels, use GET /v3/kyb/status/{userId}.

get/v3/kyb/account-status

Request

Query parameters

userIdstring required

Identifier of the business user, as returned by POST /v3/senders/business or POST /v3/recipients/business.

accountType'sender' | 'recipient' | 'both'

Product role to report on. A role block is omitted from the response when it is not selected.

Headers

MIDstring required

Merchant or sub-merchant MID

Response

OK

statusstring required

Always success for a 2xx response.

traceIdstring

Correlation id for this request. Quote it when contacting support.

Changes