Initiate verification process
Header Parameters
The matchmove issued user_id for which the request is being made
The IP using which the actor is making the request
The unique id of the device using which the actor is making the request
The user agent of the device using which the actor is making the request
The actor on behalf of whom the API request is being performed
Path Parameters
Unique identifier for your program, issued by MatchMove during onboarding. All requests must use the program_code assigned to your integration. Using a program_code that does not belong to your integration will result in an authorization error.
Body Parameters
Provider ID from the selected provider for the KYC flow
Type of user enabled for the selected provider
customerUser Hash ID
Program Code
Mode of processing the start of verification via sdk
android_sdkios_sdkweb_sdkCustomized HTTP or native URL where the final step of KYC verification would redirect to
Customized button text to be displayed on the final step of KYC verification page
Client ID; applicable only for native mode (ios/android)
Application Bundle Identifier; applicable only for native mode (ios/android)
JSON encoded string of customization details
Response
OK
Response Attributes
Indicator if the process was successful
Show child attributes
Unique identifier generated for the verification process
Unique user identifier generated for the associated verification process
SDK token
Represents the sdk details configured
Represents the redirect details configured from the process endpoint
Show child attributes
Bad Request
Returned when the verification workflow rejects the request. The response code
field indicates which specific rule was violated.
Possible error codes (surfaced from the downstream verification workflow):
invalid_payload— Malformed form/JSON request bodyinvalid_model— Missing required fields in the requestvalidation_error— A downstream service rejected the payload as invalidstill_in_progress_verification— The profile already has an ongoing KYC verification checkalready_completed_verification— The profile has already completed KYC verification
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Unauthorized
The response code field indicates which specific rule was violated.
Possible error codes:
unauthorized_error— The upstream KYC service rejected the credentials/token
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Forbidden
The response code field indicates which specific rule was violated.
Possible error codes:
forbidden_error— The upstream KYC service denied access to the resource
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Not Found
The response code field indicates which specific rule was violated.
Possible error codes (surfaced from the downstream verification workflow):
not_found_error— The referenced consumer, provider, or user could not be foundresource_not_found— The requested resource does not exist
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Internal Server Error
The response code field indicates which specific rule was violated.
Possible error codes:
resource_internal_server_error— Failed to reach/communicate with the upstream KYC serviceinternal_server_error— Unclassified error returned by the upstream KYC service
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Not Implemented
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Bad Gateway
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
KYC Orchestrator Error
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API
Gateway Timeout
Response Attributes
Unique request ID for the API request
HTTP response code for the API request
MatchMove generated error code for the API request
MatchMove generated title for the error code
Details for the error code
Details for the error code
Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons
Show child attributes
Timestamp for the processed API