Skip to content

Submit a KYC Requirement

Request

Submit a KYC requirement for a KYC Review.

  • A KYC requirement can only be submitted if the KYC Review status is WAITING_CUSTOMER_INPUT or PASSED_WITH_REQUIREMENTS.
  • A KYC requirement should only be submitted if its state is NOT_PROVIDED and apiCollectionSupported is true.

The structure of submissionData depends on the requirementKey. If you already know which requirement type you are implementing, select it in the request body to see its fields and a matching request sample.

To explore which requirement types exist and what each one collects, see the KYC requirement types guide for the full list of supported requirement types, submission data structures, and accepted values.

Security
UserToken
Path
profileIdinteger, (int64)required

The profile ID.

requirementKeystringrequired

The KYC requirement type to submit.

To see the fields for a requirement type, select it in the request body dropdown below. To compare all requirement types, see the KYC requirement types guide.

Enum:"ACCOUNT_INTENT""ACCOUNT_PURPOSE""ANNUAL_VOLUME""BUSINESS_ANNUAL_INCOME""BUSINESS_AUTHORISATION_ID""BUSINESS_AUTHORISATION_LETTER""BUSINESS_CONTROLLING_PERSON""BUSINESS_DIRECTORS_CHECK""BUSINESS_INCOME_CLASSIFICATION""BUSINESS_MONTHLY_VOLUME"
Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Example:f47ac10b-58cc-4372-a567-0e02b2c3d479
Bodymultipart/form-datarequired
Any of:

The request body depends on the requirement type being submitted. Select it from the list to see the submissionData fields and whether files are needed; the request sample updates to match.

object
curl -i -X POST \
  'https://api.wise.com/2027Q1/profiles/{profileId}/kyc-requirements/{requirementKey}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -H 'X-External-Correlation-Id: f47ac10b-58cc-4372-a567-0e02b2c3d479' \
  -d '{}'

Responses

KYC requirement successfully submitted.

Headers
X-External-Correlation-Idstring, (uuid), <= 36 characters

Echoed back when X-External-Correlation-Id was included in the request. Learn more.

Example:"f47ac10b-58cc-4372-a567-0e02b2c3d479"
x-trace-idstring

Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.

Example:"fba501b6d453b96789f52338f019341f"
Response
No content