Update user
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
First name or given name
Last name or family name
User Middle name
Prefereed name
Registration email for the user to be created in the MatchMove system for a particular program.
Supported Country codes for the program can be retrieved from GET /users/enumerations/mobile_country_codes
Minimum 8 Characters , One special character , One number , One small character
Mobile number of the user
Title to be set like mr/miss etc
MrMissDrMrsMadamId type to be set. Available values can be retrieved from GET /users/enumerations/id_types
Id number to be unique
Id type expiry date in standard date format
Issued date of id type in standard date format
Country that issued your id type. Supported values can be retrieved from GET /users/enumerations/countries
alternative id type
Alternative id type number to be unique
Alternative id type expiry date in standard date format
Alternative id type issued date in standard date format
Alternative Id type issuance country
Birthday of the user registered in matchmove system in standard date format
Place where you have born
User Nationality. Supported values can be retrieved from GET /users/enumerations/nationalities
User Gender. Supported values can be retreived from GET /users/enumerations/genders
User marital Status. Supported values can be retreived from GET /users/enumerations/marital_status
Mother's maiden name
Mother's first name. Supported values must be letters and spaces
Mother's last name. Supported values must be letters and spaces
Nature of your business
Customer id to be passed
Purpose of your account
Partner id to be passed
Client Reference ID to be passed
Agent ID to be passed
Employer Name to be passed
User Employment Type. Supported values can be retreived from GET /users/enumerations/employment_type
Source of Funds to be passed
User Occupation. Supported values can be retreived from GET /users/enumerations/occupation
Volume of Assets. Supported values can be retreived from GET /users/enumerations/volume_of_assets
Response
OK
Response Attributes
Registration email for the user to be created in the MatchMove system for a particular program.
User Name Object
Show child attributes
Show child attributes
Show child attributes
Country of issue of registration documents for the users in the MatchMove system
Country of issue of registration documents for the users in the MatchMove system
Country of issue of registration documents for the users in the MatchMove system
Birthday of the user registered in the MatchMove system. The value is expected to match the value provided in documents for the KYC process.
Mother's first name
Mother's last name
Show child attributes
Show child attributes
Risk Evaluation of the User
PENDINGIN_PROCESSCLEAREDREJECTEDEmployer name for the users in the MatchMove system
Employment type for the users in the MatchMove system. Supported values can be retreived from GET /users/enumerations/employment_type
Source of funds for user in MatchMove System
Occupation for user in MatchMove System. Supported values can be retreived from GET /users/enumerations/occupation
Volume of Assets for the users in the MatchMove system. Supported values can be retreived from GET /users/enumerations/volume_of_assets
Show child attributes
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
invalid_payload— Malformed form/JSON request bodyinvalid_model— Missing required fields in the requestvalidation_error— One or more request fields failed schema/business validationinvalid_required_request_parameters— Required request parameters are missingcustomer_information_duplicate_error— Duplicate customer information (email/mobile/identification already in use)already_completed_verification— The user has already completed verification (email/mobile change blocked)resource_user_inactive— The user is currently inactive/blocked
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 the authentication failure.
Possible error codes:
access_denied— Access is denied for this 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
Forbidden
The response code field indicates which specific rule was violated.
Possible error codes:
unauthorized_action— The consumer scope is not allowed to access this resourcerestricted_resource— This V1 route is blocked for the current program_codedisallow_updates— Updates are blocked for the user's current KYC/user statusdisallow_updates_by_field— One or more of the fields being changed are not allowed for the user's current KYC/user status
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:
route_not_defined— The route has no auth definitionuser_record_not_found— The useridwas not provided, or no user exists for the suppliedid
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:
request_fatal_internal— Fatal service 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
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
Service Unavailable
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