Skip to main content
This API is particularly useful for project administrators who need to manually review pending KYC submissions based on their project configuration. When the reviewer is set to ‘Client’ in project settings, ARGOS Agents will not review these pending submissions.
Only pending submissions can be reviewed using this API. Submissions that are already approved or rejected cannot be modified through this endpoint. Ensure that the admin email is registered in the dashboard with proper permissions for the project.

​
1. Endpoint

POST https://rest-api.argosidentity.com/v3/submission/review

​
2. Authentication

Include the API key in the x-api-key header:
x-api-key
x-api-key: {yourAPIKey}

​
3. Request Body

The request parameters should be in URL query format. Below are the field descriptions for each parameter:
​
admin
string
required
Admin account registered as an administrator in the project of the submission to be reviewed
​
submissionId
string
required
Unique ID of the pending submission to be reviewed
​
status
string
required
Status value to be changed: approved or rejected
​
rejectComment
string
required
Comment explaining the review decision (optional). Required when status is rejected
​
updateFields
string
Data fields to be updated

​
4. Request Example

POST/Review
curl --location 'https://rest-api.argosidentity.com/v3/submission/review' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {yourAPIKey}' \
--data-raw '{
    "submissionId": "string",
    "status": "string",
    "rejectComment": "string",
    "updateFields": {
      "fullName": "string",
      "gender": "string",
      "issueDate": "string",
      "expireDate": "string",
      "birthDate": "string",
      "idType": "string"
    },
    "admin": "string"
  }

​
5. Response

​
5-1. Success Response

result.json
{
    "submissionId": "string",
    "message": "Success to review submission.",
    "finalStatus": "approved"
}

​
5-2. Error Response

If an error occurs, a 400 status code is returned with details in the response body:
error.json
{
    "message": "Project not found."
}

​
5-3. Error Codes

Error TypeMessageDescription
Validation : projectProject not found.Invalid api-key or project data
Validation : projectadmin is required.admin parameter not provided
Validation : projectAccess denied. The admin is not registered in the project.admin not registered in project or invalid admin data
Validation : submissionSubmission Id is required.submission ID not provided
Validation : submissionInvalid Submission Id.Invalid submission data
Validation : submissionOnly submissions in pending status can be reviewedsubmission is not in pending status
Validation : submissionThis submission cannot be reviewed by clientsubmission not eligible for client review
Validation : request parameterInvalid statusstatus must be ‘approved’ or ‘rejected’
Validation : request parameterInvalid data format.updateFields format is incorrect (object required)
Validation : request parameterReject comment is requiredrejectedComment required when changing status to rejected
Validation : request parameterInvalid idTypeInvalid idType
Validation : request parameterInvalid genderInvalid gender
Validation : request parameterInvalid issueDate format. Use YYYY-MM-DDInvalid date format (yyyy-mm-dd required)
Validation : request parameterInvalid expireDate format. Use YYYY-MM-DDInvalid date format (yyyy-mm-dd required)
Validation : request parameterInvalid birthDate format. Use YYYY-MM-DDInvalid date format (yyyy-mm-dd required)
Processing ErrorFailed to process submissionUndefined error occurred during data processing
Processing ErrorError in submission review process.Undefined error occurred during review processing