Idcheck
idcheck-upload
POST /idcheck/upload/{id}/{step}/{type}
ID verification upload
Upload base64-encoded photo for analysis and verification
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | true | Autohost reservation ID |
| step | path | string | true | Document side (front, back, selfie) |
| type | path | string | true | Document type (drivers, passport, id) |
| pms | query | QueryParamPMS | false | PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code. |
| x-api-key | header | string | false | API Authentication Key |
| body | body | IDCheckUploadRequest | false | JSON object with DataURL or base64-encoded image |
Enumerated Values
| Parameter | Value |
|---|---|
| pms | api |
| pms | apaleo |
| pms | beds24 |
| pms | booking |
| pms | cloudbeds |
| pms | guesty |
| pms | hostaway |
| pms | hostfully |
| pms | inforhms |
| pms | impala |
| pms | lavanda |
| pms | myvr |
| pms | opera |
| pms | smartbnb |
| pms | stayntouch |
| pms | streamline |
| pms | trackhs |
Body parameter
{
"imageBase64": "data:image/jpeg;base64,<base64-encoded image>"
}
Example responses
200 Response
{
"code": "string",
"error": "string",
"card": {
"first_name": "string",
"last_name": "string",
"full_name": "string",
"birth_date": "string",
"expiry_date": "string"
}
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A analysis object | IDCheckUploadResponse |
| 500 | Internal Server Error | An error message | ErrorResponse |
Code samples
"""
Python Code Snippet
"""
import requests
headers = {
'Content-Type': 'application/json',
'Accept': 'application/json',
'x-api-key': 'string'
}
r = requests.post('https://data.autohost.ai/v1/idcheck/upload/{id}/{step}/{type}', headers=headers)
print(r.json())
/*
TypeScript Code Snippet
*/
import fetch from 'node-fetch';
const inputBody = {
"imageBase64": "data:image/jpeg;base64,<base64-encoded image>"
};
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'x-api-key':'string'
};
const response = await fetch('https://data.autohost.ai/v1/idcheck/upload/{id}/{step}/{type}', {
method: 'post',
body: JSON.stringify(inputBody),
headers,
});
const responseJson = await response.json();
console.log(responseJson);
idcheck-status
GET /idcheck/status/{id}
ID verification status
Get verification results for photos that you uploaded
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | true | Autohost reservation ID |
| pms | query | QueryParamPMS | false | PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code. |
| x-api-key | header | string | false | API Authentication Key |
Enumerated Values
| Parameter | Value |
|---|---|
| pms | api |
| pms | apaleo |
| pms | beds24 |
| pms | booking |
| pms | cloudbeds |
| pms | guesty |
| pms | hostaway |
| pms | hostfully |
| pms | inforhms |
| pms | impala |
| pms | lavanda |
| pms | myvr |
| pms | opera |
| pms | smartbnb |
| pms | stayntouch |
| pms | streamline |
| pms | trackhs |
Example responses
A verification status object
{
"status": "passed"
}
{
"status": "review",
"errors": [
"Name on document does not match reservation details"
]
}
500 Response
{
"error": "string"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A verification status object | IDCheckStatusResponse |
| 500 | Internal Server Error | An error message | ErrorResponse |
Code samples
"""
Python Code Snippet
"""
import requests
headers = {
'Accept': 'application/json',
'x-api-key': 'string'
}
r = requests.get('https://data.autohost.ai/v1/idcheck/status/{id}', headers=headers)
print(r.json())
/*
TypeScript Code Snippet
*/
import fetch from 'node-fetch';
const headers = {
'Accept':'application/json',
'x-api-key':'string'
};
const response = await fetch('https://data.autohost.ai/v1/idcheck/status/{id}', {
method: 'get',
headers,
});
const responseJson = await response.json();
console.log(responseJson);
idcheck-image
GET /idcheck/image/{id}/{step}
ID verification image
Get uploaded image for identification document on a reservation
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | true | Autohost reservation ID |
| step | path | string | true | Document side (front, back, selfie) |
| pms | query | QueryParamPMS | false | PMS integration name. If supplied, the API will assume the path parameter id is a confirmation code. |
| x-api-key | header | string | false | API Authentication Key |
Enumerated Values
| Parameter | Value |
|---|---|
| pms | api |
| pms | apaleo |
| pms | beds24 |
| pms | booking |
| pms | cloudbeds |
| pms | guesty |
| pms | hostaway |
| pms | hostfully |
| pms | inforhms |
| pms | impala |
| pms | lavanda |
| pms | myvr |
| pms | opera |
| pms | smartbnb |
| pms | stayntouch |
| pms | streamline |
| pms | trackhs |
Example responses
Identification document image encoded using Base64
{
"base64Image": "data:image/jpeg;base64,<base64-encoded image>"
}
500 Response
{
"error": "string"
}
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Identification document image encoded using Base64 | IDCheckImageResponse |
| 500 | Internal Server Error | An error message | ErrorResponse |
Code samples
"""
Python Code Snippet
"""
import requests
headers = {
'Accept': 'application/json',
'x-api-key': 'string'
}
r = requests.get('https://data.autohost.ai/v1/idcheck/image/{id}/{step}', headers=headers)
print(r.json())
/*
TypeScript Code Snippet
*/
import fetch from 'node-fetch';
const headers = {
'Accept':'application/json',
'x-api-key':'string'
};
const response = await fetch('https://data.autohost.ai/v1/idcheck/image/{id}/{step}', {
method: 'get',
headers,
});
const responseJson = await response.json();
console.log(responseJson);