1. Endpoint

GET/Submission/submissionId
GET https://rest-api.argosidentity.com/v3/submission

2. Authentication

Include the API key in the x-api-key header:

x-api-key
x-api-key: {yourAPIKey}

3. Request Parameters

The request should be in JSON format. Below is a description of the fields:

submission_id
string
required

Unique ID of a specific submission.

4. Request Example

GET/Submission/submissionId
curl --location --request GET 'https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}' \
--header 'x-api-key: {yourAPIKey}'

5. Response

5-1. Success Response

result.json
{
    "Items": [
        {
            "data": {
                "name": "Ji Sung Park",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD",
                "cf1": "{cf1}",
                "ip_address": "XXX.XXX.XXX.XXX",
                "idcard_issuingCountry": "KOR",
                "idcard_issueDate": "YYYY-MM-DD",
                "idType": "government_id"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "userid": "{userid}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ],
                "attempts": [
                    {
                        "attemptCnt": 1,
                        "retryMsg": [
                            "Liveness fail: Face is too close to one or more borders. Please retry."
                        ],
                        "retryCode": [
                            "liveness_error"
                        ]
                    },
                    {
                        "attemptCnt": 2,
                        "retryMsg": [
                            "Liveness fail: Absolute face size is too small. Please retry."
                        ],
                        "retryCode": [
                            "liveness_error"
                        ]
                    },
                    {
                        "attemptCnt": 3,
                        "livenessScore": 99,
                        "retryMsg": [
                            "The face doesn't match. Please retry with another face image."
                        ],
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    }
                ]
            }
        }
    ]
}

This API efficiently retrieves detailed information for a specific Submission ID. The response includes the applicant’s personal details, KYC results, and comprehensive information about each attempt.