Multi-Signal Requests
You can combine a document_type
with more than one value in the signals
array. This is known as a Multi-Signal Request. Multi-signal requests can be used to analyze several combinations at once, such as a barcode analysis (idcheck
) with a selfie check (selfie
) for a North American driver license (na_dl
). The private_data
request object might look like this:
{
"private_data": {
"document_type": "na_dl",
"signals": [
"idcheck",
"selfie"
]
}
}
Signal Combinations
Certain signal and document type combinations require special consideration.
Required
The following signals are required for each document type:
idcheck
is required for thena_dl
document type.ocr_scan
is required for thepassport
document type.ocr_scan
is required for theother
document type.
Interdependent
There is one interdependent signal:
ocr_match
is interdependent withocr_scan
.
Invalid
There are two invalid signal and document type combinations:
idcheck
is invalid for thepassport
document type.idcheck
is invalid for theother
document type.
The following table shows these required, interdependent, and invalid combinations.
idcheck | ocr_scan | ocr_match | |
---|---|---|---|
na_dl | Required | Valid | Interdependent with ocr_scan |
other | Invalid | Required | Interdependent with ocr_scan |
passport | Invalid | Required | Interdependent with ocr_scan |
Good Requests
Here's a good na_dl
request.
{
"private_data": {
"document_type": "na_dl",
"signals": [
"idcheck",
"ocr_match",
"ocr_scan"
]
}
}
Here's a good passport
request.
{
"private_data": {
"document_type": "passport",
"signals": [
"ocr_match",
"ocr_scan"
]
}
}
Bad Requests
Here's a bad na_dl
request because idcheck
is missing. This request would result in an unsuccessful idcheck
response object.
{
"private_data": {
"document_type": "na_dl",
"signals": [
"ocr_match",
"ocr_scan",
]
}
}
Here's a bad passport
request because idcheck
should not be requested. Only request idcheck
for na_dl
documents.
{
"private_data": {
"document_type": "passport",
"signals": [
"ocr_match",
"ocr_scan",
"idcheck"
]
}
}
Updated about 2 months ago