​
1. Base URL

GET/FaceAuth
https://rest-api.argosidentity.com/v3/faceauth

​
2. Authentication

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

​
3. Request Example

GET/FaceAuth
curl -X GET "https://rest-api.argosidentity.com/v3/faceauth" \
-H "x-api-key: {yourAPIKey}" \

​
4. Request Parameters

​
authId
string
Used for retrieving a specific submission. If authId is provided, only the corresponding submission is returned; otherwise, the full list is retrieved.
​
startDate
string
Start date of the query (yyyy-mm-dd format). To filter data within a specific period, both startDate and endDate must be provided.
​
endDate
string
End date of the query (yyyy-mm-dd format).
​
nextKey_id
string
The authId value from the nextPage_key object in the response of the previous request.
​
nextKey_date
string
The createTime value from the nextPage_key object in the response of the previous request.
​
count
string
Specifies the number of data entries to retrieve (minimum 1, maximum 2,000). If not provided, the default value is 2,000.
  • Maximum retrieval limit: A single request can retrieve up to 2,000 entries.
  • Fetching additional data: If more data is available, the response includes the nextPage_key object. To continue retrieving data, use nextPage_key’s authId as nextKey_id and createTime as nextKey_date in the next request.

​
5. Response

​
5-1. Response (delete_check: false)

result.json
[
  {
    "auth_id" : "sampleId1", 
    "auth_status" : "approved",
    "create_time" : "2023-08-18T15:00:00.000Z",
    "submit_type" : "sampleType",
    "kyc_submission_id" : "sampleKycId1",
    "policy" : {
        "faceSimilarity_threshold" : 70,
        "occluded_threshold" : false, 
        "faceCover_threshold" : 0,
        "headCover_threshold" : 50
    },
    "delete_check": false
  }
]

​
5-2. Response (delete_check: true)

result.json
[     
  { 
    "auth_id" : "sampleId1", 
    "auth_status" : "approved",
    "create_time" : "2023-08-18T15:00:00.000Z",
    "submit_type" : "sampleType",
    "kyc_submission_id" : "sampleKycId1",
    "policy" : {
        "faceSimilarity_threshold" : 70,
        "occluded_threshold" : false, 
        "faceCover_threshold" : 0,
        "headCover_threshold" : 50
    },
    "delete_check": true,
    "delete_time": "2023-09-04T02:19:01.399Z"
  }
]

​
5-3. Response Data

​
faceAuth_projectId
string
FaceAuth project ID
​
data
array
List of retrieved submissions

​
6. Error Codes

If an error occurs, a 400 status code is returned along with details in the response body:
error.json
{
    "errorCode": "required key is missing"
}
Error CodeDescription
faceAuth_project not foundThe submitted API-Key does not match any valid project. Please check if your API-Key is correct.