Checks API

NOTE: Truora provides a Postman collection online that includes the necessary tools to simplify the testing process.

Welcome to the Truora Check RESTful API reference. If you haven’t already, we strongly advise you to check out our Guides Section.

Truora Check API allows performing full background checks on people, vehicles and companies. There are three main types of background checks:

  • Personal background check: Verifies national IDs in multiple databases of public and legal entities in the LATAM region. For every national ID, returns information on: personal identity, criminal records, international background check, and professional background.
  • Vehicle background check: Verifies the vehicle documents and the owner identity in multiple databases of public and legal entities in the LATAM region. For every vehicle and owner type, returns information on: personal identity, driving records, criminal records, and vehicle information.
  • Company background check: Verifies the tax ID or a company name in multiple databases of public and legal entities in the LATAM region. For every company, returns the associated: business status, legal and criminal records, and media reports.

Authentication

To access Truora’s services and perform API calls securely, you need to authenticate your requests. This is done by including a specific authentication token, known as the โ€Truora-API-Keyโ€ in the header of your requests.

By providing this key in your API requests, you establish a secure and authorized connection, enabling seamless interaction with Truora’s services.

  • If you haven’t already, sign up for a free account here before generating your Truora-API-Key.
  • Learn how to generate your Truora-API-Key here.
Base URL

https://api.checks.truora.com

Checks

Checks API enables you to create and retrieve background checks. It consults multiple databases and provides a comprehensive set of information to assess the reliability of a person, vehicle, or company. Explore our guide on Background Checks for further details.

Create check

Creates a background check and queues it to start collecting information. The full details of background checks can be retrieved with their respective Check IDs using getCheck endpoint. Keep in mind that, depending on the check type, input document, and country of a search, certain inputs are required. You should always provide as many inputs as possible in order to get the highest accuracy.

If your check type is not referenced in the following table, please reach out to find out the fields that apply for you.

CountryPerson-NationalPerson-ForeignerCompanyVehicle-NationalVehicle-Foreigner
Chile
CL
national_id*
date_of_birth
phone_number
issue_number
foreign_id*
date_of_birth*
phone_number
first_name*
last_name*
native_country*
issue_number
N/Anational_id*
license_plate*
driver_license (Santiago only)
foreign_id*
first_name*
last_name*
date_of_birth*
native_country*
license_plate*
driver_license (Santiago only)
Colombia
CO
national_id*
date_of_birth
issue_date
phone_number
foreign_id* or PPT*
date_of_birth*
phone_number
issue_date*
tax_id*
national_id
national_id*
date_of_birth
phone_number
license_plate*
owner_document_type
owner_document_id
foreign_id*
date_of_birth
phone_number
license_plate*
issue_date*
Mexico
MX
national_id*
phone_number
foreign_id*tax_id*license_plate*
national_id
vehicle_id
driver_license(Estado de Mexico only)
N/A
Brazil
BR
national_id*
date_of_birth*
region*
phone_number
N/Atax_id*license_plate*N/A
Costa Rica
CR
national_id*
phone_number
foreign_id*
phone_number
N/Alicense_plate*N/A
Peru
PE
national_id*
date_of_birth*
phone_number
foreign_id*
ptp
date_of_birth
phone_number*
N/Anational_id*
date_of_birth*
license_plate*
foreign_id*
ptp
date_of_birth*
license_plate*
International
ALL
name*name*company_name*N/AN/A
(*) Required field

Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: person | vehicle | company | custom_type_name

Background check type. Replace custom_type_name with the name of your custom type to perform a custom type check

user_authorized boolean
[Required]

Indicates whether the person subject to the validation authorized the validation. Must be true in order to proceed [Required for API key V1 or later]

country enum
[Required]
Allowed: ALL | BR | CO | CL | MX | PE | CR

Document country

state_id string

Used for the RG (Registro Geral) identification in Brazil. This identification has different formats according to the state that issues the document. It can have numbers and letters but other characters (- * , . ) are omitted, Required in order to get complete background checks in Brazil

passport string

Person passport

issue_date string

Person document issue date in “YYYY-mm-dd” format (e.g. 2008-12-31) . This date is used to get some additional information about a person in some cases

diplomatic_id string

Diplomatic ID

national_id string

National ID

phone_number string

Person phone number. Required by law to notify the person their background is being checked

ptp string

ID for Venezuelans working in Peru

This field also apply for PPT (Permiso de Protecciรณn Temporal) in Colombia

owner_document_type string

national-id, foreign-id, tax-id or passport

escrow string

Colombian escrow

tax_id string

Company ID used for tax payments

foreign_id string

Person foreign ID

professional_card string

Professional ID card

report_id string

Report ID the background check will be inserted into

native_country enum
Allowed: CO | MX | PE | BR | EC | CL | VE

Country of birth. Required if native_national_id is provided

region enum
Allowed: DF | AC | AL | AP | AM | BA | CE | ES | GO | MA | MT | MS | MG | PA | PB | PR | PE | PI | RJ | RN | RS | RO | RR | SC | SP | SE | TO | ALL

Region where the background is to be checked in addition to the region where the person is from. By default, background checks in Brazil are performed in the person region of birth according to their CPF. Required for Brazil only. Keep in mind that a nation-wide search can take more than 24 hours to complete, whereas region-specific searches take from 2 to 20 min to complete.

Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins, ALL: nation-wide search

pep string

ID for Venezuelans working in Colombia

last_name string

Person or entity last name. If the document type and number are not provided, the report might include homonyms. Required when searching by last name. Required in order to get complete background checks in Brazil

imei string

15-digit IMEI to be validated

date_of_birth string

Person birthdate. This date is used to get some additional information about a person and to filter homonyms in some cases. YYYY-MM-DD format, Required for complete background checks in Brazil and Perรบ

driver_license string

Driver’s license number

license_plate string

Vehicle license plate

issue_number string

Document number of Chilean identity. This number is used to get some additional information about a person. Chile only

owner_document_id string

ID of the vehicle owner

payment_date string

Payment day of a vehicle circulation permit (Chile only)

native_national_id string

National ID from the person native country. Keep in mind that you must provide the native_country if you enter a native_national_id

verification_code string

Verification code registered for criminal records in Peru and Chile

watch string

Indicates whether the check score is to be periodically revised and its frequency. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by d: day, w: week, m: month, y: year for instance: 3d: every three days, 2w: every two weeks. Ignore this field if the check is only to be performed once

certificate_folio string

Folio for Chilean certificate search. Chile only

company_name string

Company name “Don’t forget this required field to complete background checks in Brazil”

force_creation boolean

Defines the behavior of the API when creating a background check with the same input values used for a recently created background check.

When true, forces the creation of a new background check; otherwise, it returns the result of the background check created earlier.

vehicle_id string

Vehicle NIV number

birth_certificate string

Person birth certificate

first_name string

Person or entity first name. If the document type and number are not provided, the report might include homonyms. Required when searching by first name, Required in order to get complete background checks in Brazil

post /v1/checks

object

CheckOutput

Field Type Description
check object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
details string Detail path
self string Background check URL

List checks

Lists all the existing checks created in the account. If report_id is provided, it will only return the checks from the report

object

ChecksOutput

Field Type Description
checks array Background check list in the page
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
next string Next page path
self string Current page path
Query Parameters
report_id string
[Optional]
ID of the report of background checks to be returned.
start_key string
[Optional]
Start key value for the pagination.

Get check

Returns the results of the check that matches the ID provided, complete with a set of scores explained below.

Scores:

  • Global Score: Average risk associated with a person, company or vehicle, according to the background check results. The global score considers results that are validated with the ID number provided. The score ranges from 0 to 1, where 0 represents high risk and 1 low risk.
  • ID Score: Average risk associated with a person according to the background check results. The ID score considers the results that are validated with a person identity document. The score ranges from 0 to 1, where 0 represents high risk and 1 low risk.
  • Name Score: Average risk associated with a person according to the background check results. The name score considers results that are validated against the name of a person and could not be validated with their ID number. These results might have homonyms associated with them. The score ranges from 0 to 1, where 0 represents high risk and 1 low risk.

In order to calculate these scores, a weighted average is considered with different weights allocated to each dataset. Scores can be customized using the config endpoints by assigning a weight to each dataset according to its relevance.

Keep in mind that results from the API vary depending on the country, check type and the inputs entered on check creation.

Response
get /v1/checks/{check_id}

object

CheckOutput

Field Type Description
check object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
details string Detail path
self string Background check URL
Path Parameters
check_id string
[Required]
A unique identifier for a check.

Get Check Attachments

Enables the download of PDF documents associated with the check result. This will list all the files found for a given check and provide the link for downloading
Response
get /v1/checks/{check_id}/attachments

object

CheckOutput

Field Type Description
check object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
details string Detail path
self string Background check URL
Path Parameters
check_id string
[Required]
A unique identifier for a check.

List Check Details

Lists all details associated with a check, with support for pagination. It includes a list of data sources along with their respective information
Response
get /v1/checks/{check_id}/details
Path Parameters
check_id string
[Required]
A unique identifier for a check.
Query Parameters
lang string
[Optional]
Specifies the desired language for details; use lowercase ISO 639-1 format. If not specified, details will be provided in their original language.
start_key string
[Optional]
Start key value for the pagination.

Summarize

Returns a summary in a human readable way for the specified check id. It is useful when the details of the check are too long when reviewing manually
Response
get /v1/checks/{check_id}/summarize
Path Parameters
check_id string
[Required]
A unique identifier for a check.

Get the status of a database

Retrieve the current status of all databases that match with query parameters. This endpoint assists in determining the suitability of making a Check, allowing to review the availability of a database at any given moment.
Response
get /v1/health
Query Parameters
country string
[Required]
Country code in uppercase ISO 3166 format (e.g., CO for Colombia).
unixTimestampSeconds number
[Required]
Unix timestamp in seconds. Send a day timestamp to view the database hourly status for that day or send the current time to know the current database status.
unixtimezoneOffsetSeconds number
[Required]
Offset between the local time and the UTC time in seconds. (e.g., Colombia is at UTC -18000 seconds).

Delete check

Deletes the check that matches the Check ID provided, along with relevant information about that specific check. If the check belongs to a continuous check, it will be deleted only if isn’t the first one.
Response
delete /v1/checks/{check_id}

object

CheckOutput

Field Type Description
check object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
details string Detail path
self string Background check URL
Path Parameters
check_id string
[Required]
A unique identifier for a check.

Custom-Type

The Custom Type API enables the creation of custom searches, allowing you to include only the desired datasets in background checks, thus enhancing the check efficiency. Moreover, you can customize the impact of each dataset on the global score by assigning it a weight value between 0 and 1. It’s important to note that the sum of all weights must equal 1.

You can use custom types in your checks to perform custom-type checks. For detailed information, refer to our Custom Type guide.

Create custom type

Create a custom type selecting the weight for each background check dataset and the country where it applies. Weights are numbers between 0 and 1 that represent how impactful the dataset is for the score, where datasets with weight 0 do not influence the score but are searched nonetheless. Keep in mind that the sum of all weights must equal 1. To perform a check with the custom type, create a Check and enter the name you gave to your custom type in type
Request
Request Body *application/x-www-form-urlencoded
country enum
[Required]
Allowed: ALL | BR | CL | CO | MX | PE

Country where this set of rules applies. Use “all” if the check type searches by name by relying on international databases

type string
[Required]

Custom type name. It cannot be person, vehicle, or company. Use this type in your checks to perform custom-type checks

dataset_affiliations_and_insurances number

Affiliation and insurance weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_legal_background number

Legal background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_personal_identity number

Personal identity weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_professional_background number

Professional background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_business_background number

Business background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_traffic_fines number

Traffic fines weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_criminal_record number

Criminal record weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_taxes_and_finances number

Taxes and financial background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_vehicle_information number

Vehicle information weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_international_background number

International background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_driving_licenses number

Driving license weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_alert_in_media number

Alert in media weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_vehicle_permits number

Vehicle certificate background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

Response
post /v1/config

object

ScoreConfigOutput

Field Type Description
ScoreConfigByCountry array List of custom types that apply for the country
data_set string Background check dataset
weight string Dataset weight for score calculation

Update custom type

Allows updating a custom type. Person, vehicle, and company types are not modifiable. Please visit How to Create a Custom Type for Background Check guide for more information.
Request
Request Body *application/x-www-form-urlencoded
type string
[Required]

Custom type name. It cannot be person, vehicle, or company. Use this type in your checks to perform custom-type checks

country enum
[Required]
Allowed: ALL | BR | CL | CO | MX | PE

Country where this set of rules applies. Use “all” if the check type searches by name by relying on international databases

dataset_vehicle_permits number

Vehicle certificate background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_vehicle_information number

Vehicle information weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_taxes_and_finances number

Taxes and financial background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_alert_in_media number

Alert in media weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_criminal_record number

Criminal record weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_legal_background number

Legal background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_personal_identity number

Personal identity weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_professional_background number

Professional background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_business_background number

Business background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_driving_licenses number

Driving license weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_international_background number

International background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_affiliations_and_insurances number

Affiliation and insurance weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

dataset_traffic_fines number

Traffic fines weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time

Response
put /v1/config

object

CreateConfigInput

Field Type Description
country string Country where this set of rules applies. Use "all" if the check type searches by name by relying on international databases
Options: ALL| BR| CL| CO| MX| PE
dataset_affiliations_and_insurances number Affiliation and insurance weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_alert_in_media number Alert in media weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_business_background number Business background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_criminal_record number Criminal record weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_driving_licenses number Driving license weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_international_background number International background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_legal_background number Legal background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_personal_identity number Personal identity weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_professional_background number Professional background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_taxes_and_finances number Taxes and financial background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_traffic_fines number Traffic fines weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_vehicle_information number Vehicle information weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_vehicle_permits number Vehicle certificate background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
type string Custom type name. It cannot be person, vehicle, or company. Use this type in your checks to perform custom-type checks

List custom types

Lists all custom types of the associated account. Please visit How to Create a Custom Type for Background Check guide for more information.
Response
get /v1/config

object

ScoreConfigsOutput

Field Type Description
score_configs array The list of custom types
ScoreConfigByCountry array List of custom types that apply for the country
data_set string Background check dataset
weight string Dataset weight for score calculation
Query Parameters
start_key string
[Optional]
Start key value for the pagination.

Delete custom type

Allows deleting a custom type. Please note that person, vehicle, and company custom types can not be deleted.

After deletion, the response will display the remaining custom types associated with the country of the deleted custom type.

Response
delete /v1/config

object

CreateConfigInput

Field Type Description
country string Country where this set of rules applies. Use "all" if the check type searches by name by relying on international databases
Options: ALL| BR| CL| CO| MX| PE
dataset_affiliations_and_insurances number Affiliation and insurance weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_alert_in_media number Alert in media weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_business_background number Business background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_criminal_record number Criminal record weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_driving_licenses number Driving license weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_international_background number International background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_legal_background number Legal background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_personal_identity number Personal identity weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_professional_background number Professional background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_taxes_and_finances number Taxes and financial background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_traffic_fines number Traffic fines weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_vehicle_information number Vehicle information weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
dataset_vehicle_permits number Vehicle certificate background weight for score calculation. From 0 to 1. If not provided, the dataset is skipped entirely decreasing the search time
Format: float
type string Custom type name. It cannot be person, vehicle, or company. Use this type in your checks to perform custom-type checks
Query Parameters
country string
[Required]
Country where the custom type is valid. Use ISO 3166 format in uppercase (e.g., CO for Colombia)
type string
[Required]
Name of the custom type to be deleted.

Settings

Allows the configuration of parameters such as names matching type, retries and max duration.

Create setting

Allows setting up both retries and names matching type. Keep in mind that this feature is a configuration at a Client level, so it will affect all your check types.
Request
Request Body *application/x-www-form-urlencoded
retries boolean

Indicates whether or not database queries must be retried until they successfully return a response or until the max_duration time is reached

max_duration string

Indicates the maximum amount of time a check can take to fetch responses. It follows the following format "xt" where x is a number and t is a letter ( m for minutes or h for hours). Example 25m indicates 25 minutes, 2h indicates 2 hours. This value must be between 15 minutes and 7 days (168 hours). When not configured, it is set to default. If retries is enabled, the default max duration is set to 48 hours; otherwise, it is set to 3 hours for Colombia, Mexico, Peru, and Brazil; 48 hours for Chile and International searches; and 72 hours for Costa Rica

names_matching_type enum
Allowed: soft | exact

Defines the matching type between the names retrieved from the identity databases and the names found in the criminal, legal and international databases to determine whether a record should be included in the check or not. soft (used by default) means matching names when they are similar enough to be considered the same person (e.g., Maria Alejandra Gomez would match Alejandra Gomez). exact means the names must perfectly match. Keep in mind that this feature is a configuration at a Client level, so it will affect all your check types

Response
post /v1/settings

object

Settings

Field Type Description
max_duration string Indicates the maximum amount of time a check can take to fetch responses. It follows the following format ``"xt"`` where ``x`` is a number and ``t`` is a letter ( ``m`` for minutes or ``h`` for hours). Example ``25m`` indicates 25 minutes, ``2h`` indicates 2 hours. This value must be between 15 minutes and 7 days (168 hours). When not configured, it is set to ``default``. If ``retries`` is enabled, the default max duration is set to 48 hours; otherwise, it is set to 3 hours for Colombia, Mexico, Peru, and Brazil; 48 hours for Chile and International searches; and 72 hours for Costa Rica
names_matching_type string Defines the matching type between the names retrieved from the identity databases and the names found in the criminal, legal and international databases to determine whether a record should be included in the check or not. ``soft`` (used by default) means matching names when they are similar enough to be considered the same person (e.g., Maria Alejandra Gomez would match Alejandra Gomez). ``exact`` means the names must perfectly match. Keep in mind that this feature is a configuration at a Client level, so it will affect all your check types
Options: soft| exact
retries boolean Indicates whether or not database queries must be retried until they successfully return a response or until the ``max_duration`` time is reached

Continuous

Enables the creation of recurring checks with customizable frequency, providing notifications whenever there are changes in check scores.

Create Continuous Check

Creates a continuous check that will run background checks recurrently according to the frequency provided.
Request
Request Body *application/x-www-form-urlencoded
frequency string
[Required]

Time between background checks. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by a letter d: day, w: week, m: month, y: year. For instance: 3d: every three days, 2w: every two weeks

end_date string
[Required]

Date on which background checks will stop. YYYY-MM-DD format. For the date to be valid, it must allow at least one check to be run according to the frequency.

check_id string
[Required]

Background checks to be processed recurrently

Response
post /v1/continuous-checks

object

ContinuousCheck

Field Type Description
ContinuousCheckID string Continuous check ID [partition key and sort key]
ContinuousCheckStatus string Shows whether the background check score rose, fell, stood the same or was just created
Options: new| up| down| same
CreationDate string Continuous check creation date in RFC3339 format
Format: date
Enabled boolean Indicates whether continuous check is enabled
Frequency string Time between background checks. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by d: day, w: week, m: month, y: year for instance: 3d: every three days, 2w: every two weeks
History object
changes array Change list of background check scores
dataset_score_changes number Old and new score map by dataset
score_changes array Old and new score list
check_id string Check ID
continuous_check_id string Continuous check ID
creation_date string Continuous check creation date in RFC3339 format
Format: date
previous_check_id string Previous check ID
LastCheckID string Last check ID
NextRunDate string Next background check date, in RFC3339 format (without time)
Format: date
OriginalCheck object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
UpdateDate string Continuous check update date in RFC3339 format
Format: date
version string API Key version to be used for the continuous check hooks. This version must match API key version you use.
Options: 0| 1

Update Continuous Checks

Updates a continuous check using its ID. This method can only modify its frequency and status
Request
Request Body *application/x-www-form-urlencoded
status enum
Allowed: enabled | disabled

Indicates whether the background checks must be processed recurrently

version enum
Allowed: 0 | 1

API Key version to be used for the continuous check hooks. This version must match API key version you use. Version 0 is used by default.

frequency string

Time between background checks

Response
put /v1/continuous-checks/{continuous_check_id}

object

ContinuousCheck

Field Type Description
ContinuousCheckID string Continuous check ID [partition key and sort key]
ContinuousCheckStatus string Shows whether the background check score rose, fell, stood the same or was just created
Options: new| up| down| same
CreationDate string Continuous check creation date in RFC3339 format
Format: date
Enabled boolean Indicates whether continuous check is enabled
Frequency string Time between background checks. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by d: day, w: week, m: month, y: year for instance: 3d: every three days, 2w: every two weeks
History object
changes array Change list of background check scores
dataset_score_changes number Old and new score map by dataset
score_changes array Old and new score list
check_id string Check ID
continuous_check_id string Continuous check ID
creation_date string Continuous check creation date in RFC3339 format
Format: date
previous_check_id string Previous check ID
LastCheckID string Last check ID
NextRunDate string Next background check date, in RFC3339 format (without time)
Format: date
OriginalCheck object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
UpdateDate string Continuous check update date in RFC3339 format
Format: date
version string API Key version to be used for the continuous check hooks. This version must match API key version you use.
Options: 0| 1
Path Parameters
continuous_check_id string
[Required]
Unique ID assigned after calling CreateContinuousCheck.

List Continuous Checks

Lists all continuous checks created in the given account. This method returns the ’next’ attribute to paginate for the next results
Response
get /v1/continuous-checks

object

ListContinuousChecksOutput

Field Type Description
continuous_checks array List of continuous checks in current page Default: all
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
next string Next page URL
self string Current page URL

Get Continuous Checks

Returns the specified continuous check using its ID. This method returns the last check executed and provides information such as frequency, status, count and end date
Response
get /v1/continuous-checks/{continuous_check_id}

object

ContinuousCheck

Field Type Description
ContinuousCheckID string Continuous check ID [partition key and sort key]
ContinuousCheckStatus string Shows whether the background check score rose, fell, stood the same or was just created
Options: new| up| down| same
CreationDate string Continuous check creation date in RFC3339 format
Format: date
Enabled boolean Indicates whether continuous check is enabled
Frequency string Time between background checks. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by d: day, w: week, m: month, y: year for instance: 3d: every three days, 2w: every two weeks
History object
changes array Change list of background check scores
dataset_score_changes number Old and new score map by dataset
score_changes array Old and new score list
check_id string Check ID
continuous_check_id string Continuous check ID
creation_date string Continuous check creation date in RFC3339 format
Format: date
previous_check_id string Previous check ID
LastCheckID string Last check ID
NextRunDate string Next background check date, in RFC3339 format (without time)
Format: date
OriginalCheck object
billing_hub string Billing hub the check belongs to. Billing hubs allow separating your usage of Truora searches for transparency and traceability.
birth_certificate string Person birth certificate
check_id string Background check ID
company_summary object
company_status string Describes the status of the company. ``active`` means the company's RUT is active, ``cancelled`` means the company's RUT is not active, ``not_reinscribed`` means an old company's NIT has not been updated in the RUT, ``suspended`` means the company registry has been suspended, ``incapable`` means the company registry has been deemed uncapable, ``not_found`` means the company wasn't found, and ``found`` indicates the company was found but it has no other specific status.
Options: active| cancelled| not_reinscribed| suspended| incapable| not_found| found
names_found array Names found during the background check process
company_name string Company name found in the background check
count integer Times this name was found during the background check process
result string summary result
Options: found| not_found| skipped| in_progress
country string ID Document country
Options: ALL| BR| CO| CL| MX| PE| CR
creation_date string Background check creation date
Format: date-time
date_of_birth string Person birthdate. Shown only if provided during check creation. YYYY-MM-DD format
Format: date-time
diplomatic_id string Person diplomatic id
driver_license string Person driver's license
first_name string Person or entity first name. Shown only if provided during check creation
foreign_id string Person foreign identification
id_score number Background check score regarding results by ID number only. It is a number between 0 and 1 where 1 is the best score. This result is a weighted average of the id_scores listed under scores.
Format: float
issue_date string Issue date of the person ID
Format: date-time
last_name string Person or entity last name. Shown only if provided during check creation
license_plate string Vehicle license plate
name_score number Background check score including results by name only. This might contain homonym information
Format: float
national_id string Person national identification
native_country string Person origin country
Options: ad| ae| af| ag| ai| al| am| an| ao| aq| ar| as| at| au| aw| ax| az| ba| bb| bd| be| bf| bg| bh| bi| bj| bm| bn| bo| br| bs| bt| bv| bw| by| bz| ca| cc| cd| cf| cg| ch| ci| ck| cl| cm| cn| co| cr| cu| cv| cx| cy| cz| de| dj| dk| dm| do| dz| ea| ec| ee| eg| eh| er| es| et| fi| fj| fk| fm| fo| fr| ga| gb| gd| ge| gf| gg| gh| gi| gl| gm| gn| gp| gq| gr| gs| gt| gu| gw| gy| hk| hm| hn| hr| ht| hu| id| ie| il| im| in| io| iq| ir| is| it| je| jm| jo| jp| ke| kg| kh| ki| km| kn| kp| kr| kw| ky| kz| la| lb| lc| li| lk| lr| ls| lt| lu| lv| ly| ma| mc| md| me| mg| mh| mk| ml| mm| mn| mo| mp| mq| mr| ms| mt| mu| mv| mw| mx| my| mz| na| nc| ne| nf| ng| ni| nl| no| np| nr| nu| nz| om| pa| pe| pf| pg| ph| pk| pl| pm| pn| pr| ps| pt| pw| py| qa| re| ro| rs| ru| rw| sa| sb| sc| sd| se| sg| sh| si| sj| sk| sl| sm| sn| so| sr| st| sv| sy| sz| tc| td| tf| tg| th| tj| tk| tl| tm| tn| to| tr| tt| tv| tw| tz| ua| ug| um| us| uy| uz| va| vc| ve| vg| vi| vn| vu| wf| ws| ye| yt| za| zm| zw
owner_document_id string Vehicle owner identification
owner_document_type string Vehicle owner document type
passport string Person passport
payment_date string Vehicle license payment date
pep string Colombian PEP idenfitication for Venezuelans
phone_number string Person phone number. Required by law in order to notify the person their background is being checked
professional_card string Person professional card number
ptp string Temporary residence permit of the person
region string Region where the background is to be checked. By default, background checks in Brazil are performed in region where the person is from. Applies for some Brazil collectors only. Allowed values are: DF: Distrito Federal, AC: Acre, AL: Alagoas, AP: Amapรก, AM: Amazonas, BA: Bahรญa, CE: Cearรก, ES: Espรญrito Santo, GO: Goiรกs, MA: Maranhรฃo, MT: Mato Grosso, MS: Mato Grosso do Sul, MG: Minas Gerais, PA: Parรก, PB: Paraรญba, PR: Paranรก, PE: Pernambuco, PI: Piauรญ, RJ: Rรญo de Janeiro, RN: Rรญo Grande do Norte, RS: Rรญo Grande do Sul, RO: Rondรดnia, RR: Roraima, SC: Santa Catarina, SP: Sรฃo Paulo, SE: Sergipe, TO : Tocantins.
Options: DF| AC| AL| AP| AM| BA| CE| ES| GO| MA| MT| MS| MG| PA| PB| PR| PE| PI| RJ| RN| RS| RO| RR| SC| SP| SE| TO
report_id string Report ID the background check is associated with
score number Background check score. Number between 0 and 1 where 1 is the best score
Format: float
scores array Background check score of each profile group and dataset
by_id object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
by_name object
result string Overall result of the data collected. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity string Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none
Options: unknown| none| very_low| low| medium| high| very_high
data_set string Dataset summed up to create the score
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
result string Overall result of the data collected in the dataset. If at least one collected data status is found, the result will be found, otherwise, it will be the most frecuent status
Options: pending| found| not_found| error| delayed| ignored
score number Dataset score. Number between 0 and 1 where 1 is the best score.
Format: float
severity Risk asociated with each category for the search according to the information found. None is returned when the person, vehicle or company is in the clear. Unknown is returned when the score is none due to a problem with one of the searches
Options: unknown| none| very_low| low| medium| high| very_high
status string Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the check finished successfully, **error** means the check failed, **in_progress** means the check is currently being processed, **delayed** means the check is waiting for an additional requirement to be met, this can last up to 3 days. **Completed** and **error** are the two only final statuses
Options: not_started| in_progress| completed| error| delayed
statuses array Database status list
data_set string Background check dataset
Options: affiliations_and_insurances| alert_in_media| behavior| business_background| criminal_record| driving_licenses| international_background| legal_background| personal_identity| professional_background| traffic_fines| vehicle_information| vehicle_permits| taxes_and_finances
database_id string Database ID. Can be used to verify the database status
database_name string Background check database name. Do not use this field to identify the database as it may change during the check execution. Use database_id instead
invalid_inputs array List of missing or invalid inputs
status Result status of the background check. **Not_started** means the background check is still in queue, since there is a limit of background checks that can be processed simultaneously, **completed** means the search finished successfully, **error** means the search failed, **expired** means the search took too long to finish and therefore failed, **skipped** means the search failed because a wrong number or type of parameters was provided, **delayed** means the search is waiting for an additional requirement to be met and can last up to 3 days
Options: not_started| completed| expired| error| delayed| skipped
summary object
date_of_birth string Person date of birth in RFC3339 format
Format: date-time
death_date string Person date of death
Format: date-time
drivers_license string Person driver's license
gender string Person gender
Options: male| female
identity_status string Indicates whether a person was found, found as dead or not found at all
Options: found| not_found| dead
names_found array Names found during the background check process
count integer Times this name was found during the background check process
first_name string First name found in the background check
last_name string Last name found in the background check
nss string Social security number of the person (Mexico)
result string Check summary result
Options: found| not_found| skipped| in_progress
rfc string Federal taxpayer registration number of the person
tax_id string Person or company tax id
type Background check type
Options: company| person| vehicle
update_date string Background check update date
Format: date-time
vehicle_id string Vehicle identification
vehicle_summary object
capacity integer Number of passengers allowed to travel in the vehicle
color string Vehicle color
license_plate string Vehicle license plate
manufacturer string Vehicle manufacturer
model string Vehicle model
number_of_doors integer Vehicle door count
obligatory_insurance_expiration_date string Expiration date of the vehicle compulsory insurance
Format: date
obligatory_insurance_status string Status of the vehicle compulsory insurances
result string Vehicle summary result
Options: found| not_found| skipped| in_progress
service_type string Vehicle service type
vehicle_category string Vehicle category
vehicle_id string Vehicle ID
vehicle_status string Status of the vehicle
Options: found| not_found
vehicle_type string Vehicle type
year integer Vehicle model year
wrong_inputs array List of parameters entered during background check creation that do not match the information obtained
Input string Parameter entered that differs from the information obtained. ``tax_id`` is returned when the names found by ``tax_id`` and ``national_id`` do not match
Options: document_expedition_date| first_name| last_name| tax_id
UpdateDate string Continuous check update date in RFC3339 format
Format: date
version string API Key version to be used for the continuous check hooks. This version must match API key version you use.
Options: 0| 1
Path Parameters
continuous_check_id string
[Required]
Unique ID assigned after calling CreateContinuousCheck.

List Continuous Check Logs

Returns Continuous Check Logs. These logs are useful for analyzing the behavior of the check over time. Each entry includes details of what changed
Response
get /v1/continuous-checks/{continuous_check_id}/history

object

GetContiuousCheckHistoryOutput

Field Type Description
history array List of background check changelogs
dataset_score_changes number Old and new score map by dataset
score_changes array Old and new score list
next string Next page URL
self string Current page URL
Path Parameters
continuous_check_id string
[Required]
Unique ID assigned after calling CreateContinuousCheck.

PDF

Enables the export of a comprehensive PDF containing the obtained information, Truora’s assigned score, and consulted datasets. For more details, refer to Background Checks: PDF, Variables and Attachments guide.

Create PDF

Create PDF receives a check id and starts the conversion to PDF. Once the method is finished, it will return a link where the file can be downloaded
Response
post /v1/checks/{check_id}/pdf
Path Parameters
check_id string
[Required]
A unique identifier for a check.

Get PDF

Get PDF downloads the PDF in the specified language, Spanish by default. This endpoint must be called after making the POST call
Response
get /v1/checks/{check_id}/pdf
Path Parameters
check_id string
[Required]
A unique identifier for a check.
Query Parameters
lang string
[Optional]
Specifies the language of the PDF; use lowercase ISO 639-1 format. If not specified, the PDF will be downloaded in Spanish by default.

Batch

Given a valid xlsx file, this endpoint takes the information from the file and starts creating the checks and associating it to the specified report object. For a step-by-step explanation of all methods and required fields for submitting a batch, please refer to the Background Checks Batch via API guide.

Create Batch

This endpoint facilitates the creation of batches of different types. This endpoint does not include input file uploading or batch start logic.

The check inputs to be uploaded in the file can be manually mapped using columns_mapping.{input_name} body params, by default the inputs accepted by the check type will be mapped. The request will return a columns array with the order in which the inputs should be in the xlsx file.

The batch creation request returns a temporary URL in the file_upload_link field. This URL must be used to make a PUT request with the file containing the mapped batch data. It is crucial to note that the URL has a limited expiration time (30min) and will only allow the first submitted file to be uploaded. Therefore, it is highly recommended to carefully review the information before uploading.

Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: person | vehicle | company | custom_type_name

Type of the batch checks. Replace custom_type_name with the name of your custom type to perform a batch of custom type checks. In case you want to create a custom type please visit How to Create a Custom Type for Background Check guide for more information.

service enum
[Required]
Allowed: checks

The service for which the batch will be processed

country enum
[Required]
Allowed: ALL | BR | CO | CL | MX | PE | CR

The country of batch checks

end_date string

Date on which background checks will stop to create a batch of continuous checks. YYYY-MM-DD format. For the date to be valid, it must allow at least one check to be run according to the frequency.

frequency string

Time between background checks to create a batch of continuous checks. It can be daily, weekly, monthly, yearly or have a custom frequency written as a number accompanied by a letter d: day, w: week, m: month, y: year. For instance: 3d: every three days, 2w: every two weeks

columns_mapping.{input_name} number

Columns mapping of the xlsx file. This body parameter must be sent for each column you want to upload in the xlsx file, replacing the input_name with the name of the input (e.g. columns_mapping.national_id). The value must be the index of the column in the file, being 0 for column A, 1 for column B and so on. If no column mapping is sent, all inputs for the selected custom type will be automatically mapped.

post /v1/batches

object

OutputMessage

Field Type Description
message string Message

Request Batch Report Generation

This endpoint requests the generation of a report for a specific batch. The format of the report can be specified via a query param.
Request
Request Body *application/x-www-form-urlencoded
format string
[Required]

Batch report file format

Response
post /v1/batches/{batch_id}/report

object

OutputMessage

Field Type Description
message string Message
Path Parameters
batch_id string
[Required]
Unique identifier of the batch.

Start Batch

This endpoint starts the execution of a specific batch. The batch needs to have an uploaded file for this to succeed.
post /v1/batches/{batch_id}/start

object

OutputMessage

Field Type Description
message string Message
Path Parameters
batch_id string
[Required]
Unique identifier of the batch.

Stop Batch

This endpoint is used to stop a specific batch (updating its status to “stopped”) only if it’s currently in progress or not started yet.
Response
put /v1/batches/{batch_id}

object

OutputMessage

Field Type Description
message string Message
Path Parameters
batch_id string
[Required]
Unique identifier of the batch.

Get Batch

This endpoint returns a specific batch’s information, including its creation date, size, status and failure reason.
Response
get /v1/batches/{batch_id}

object

OutputMessage

Field Type Description
message string Message
Path Parameters
batch_id string
[Required]
Unique identifier of the batch.

Get Batch Report

This endpoint obtains a previously requested batch report. If no report exists yet for the batch it returns a 404 response.
get /v1/batches/{batch_id}/report

object

OutputMessage

Field Type Description
message string Message
Path Parameters
batch_id string
[Required]
Unique identifier of the batch.

Shared Accounts

Truora Shared accounts API allows accessing services that are transversal to all other services like Background checks or Validators

Authentication

To access Truora’s services and perform API calls securely, you need to authenticate your requests. This is done by including a specific authentication token, known as the โ€Truora-API-Keyโ€ in the header of your requests.

By providing this key in your API requests, you establish a secure and authorized connection, enabling seamless interaction with Truora’s services.

  • If you haven’t already, sign up for a free account here before generating your Truora-API-Key.
  • Learn how to generate your Truora-API-Key here.
Base URL

https://api.account.truora.com

Digital Identity

NOTE: Truora provides a Postman collection online that includes the necessary tools to simplify the testing process.

Truora Digital Identity (Truora DI) is a versatile platform that allows you to create a personalized process for authenticating your users. It enables you to utilize a range of Validators in a single process to simplify user identity verification. The Validators enable diverse actions, ranging from verifying that a phone or email belongs to the user, to matching usersยด biometrics against government sources. The platform offers the flexibility to create the processes securely and without introducing complexity to the user experience, ensuring your new users can promptly access and enjoy your services.

Authentication

To access Truora’s services and perform API calls securely, you need to authenticate your requests. This is done by including a specific authentication token, known as the โ€Truora-API-Keyโ€ in the header of your requests.

By providing this key in your API requests, you establish a secure and authorized connection, enabling seamless interaction with Truora’s services.

  • If you haven’t already, sign up for a free account here before generating your Truora-API-Key.
  • Learn how to generate your Truora-API-Key here.
Base URL

https://api.connect.truora.com

Web

Digital Identity Web is a versatile platform that allows you to create a customized process to authenticate your users. It allows you to use a number of validators in a unique process to simplify user identity verification.

Here you will find the endpoints you need to create process links and get results. If you need to create process flows please see the Documentation.

Generate Token

Once the flow has been created and published, a POST request must be made to generate a temporary API Key. This should be generated every time a user validation is performed.
Request
Request Body *application/x-www-form-urlencoded
key_type enum
[Required]
Allowed: backend | web

API key type

key_name string

API key name. Required only if key_type was set to backend

country enum
Allowed: ALL | BR | CL | CO | CR | EC | MX | PE | AR

Country for the identity verification process. Required only if grant is set to digital-identity

api_key_version string

API key version. Version 0 is used by default

billing_hub string

Billing hubs allow for separated counters and billing. Required if the customer uses billing hubs

document_type enum
Allowed: passport | driver-license | foreign-id | national-id | pep

Document type for the identity verification process. Only used if grant is set to digital-identity

emails array

List of emails to be validated during the identity verification process

flow_id string

Validation flow to be performed for the identity verification process. Required only if grant is set to digital-identity

grant enum
Allowed: digital-identity | signals

Indicates which service this API key grants access to. Required if key_type is set to web or sdk

account_id string

User identifier for the person who will perform digital-identity validation. Only used if grant is set to digital-identity. If not sent it is generated automatically. Note that only Account IDs following the regex pattern [a-zA-Z0-9_.-]+ are supported. Please go to Create an Account ID to learn more about it.

redirect_url string

URL where the user is to be redirected once the verification process has ended. Required if grant is set to digital-identity

phones array

List of phone numbers to be validated during the identity verification process

Response
post /v1/api-keys

object

CreateAPIKeyOutput

Field Type Description
api_key string API key
message string API key message

Get Result

Allows you to retrieve the current status and details of a process. The status begins as pending and updates to either success or failure when the process completes.

  • Pending: The process is still ongoing.
  • Success: All steps in the process have been successfully completed. If the flow includes validators, all validation_status values must also be successful.
  • Failure: Occurs due to an internal error, timeout, or if the process is declined or expired.

Here’s a comprehensive list of reasons why a process or validation might be declined or expired, as recorded in the declined_reason and expired_reason fields:

If a process includes validators and the identity process times out because a validation did not complete, but all inputs have been uploaded, the system grants an additional 5 minutes to receive a validation response with the final status. This behavior occurs up to 3 times.

On the final attempt to retrieve the validation response, if the validation remains in the pending status, the identity process status will update to failure, with failure_status set to expired.

If a process includes the attributes override_status and override_status_history, it means the final status was modified by an authorized user. In this case, use the override_status attribute instead of status to determine the final status of the process. The override_status_history attribute will contain the history of changes made to the status.

get /v1/processes/{process_id}/result

object

resultOutput

Field Type Description
account_id string Account ID
client_id string Client ID
client_user_id string Client User ID
country string Country for the validation
Options: CO| BR| MX| EC| ALL
failure_status string Defines the reason why the processes failed.
flow_id string ID of the identity flow
flow_version string Flow version
process_id string Process ID
status string process status
Options: success| failure| pending
validations array List of validations performed
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``. <a href=" https://developer.truora.com/products/digital-identity/declined_reasons.html ">Learn more about the reasons why the process may be declined.</a>
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: face-recognition| email-verification| phone-verification| document-validation| electronic-signature
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
process_id string
[Required]
The ID of the process for which results are being retrieved.

WhatsApp

WhatsApp can be used as a channel to reach users through flows. Using WhatsApp Business Account (WABA), you would be able to send and receive messages through the WhatsApp Business API for your business processes, interactions with your users or create validation processes, accounts as a document, document + face, email, phone number, electronic signature, and background. There are two different types of messages that can be used through WhatsApp Business, incoming messages (inbound) and outgoing messages (outbound).

Update Inbound Flow

Allows updating an inbound flow.

Note: Do not forget that if you already have a whatsapp link created and you update it, you must generate a new link.

Request
Request Body *application/x-www-form-urlencoded
waba_phone_number string

Phone number of the WABA that interacts with the users. Must include the country code. Example 14080001111.

flow_id string

Identifier of the Flow previously created.

inbound_message string

Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.

object

CreateInboundFlowOutput

Field Type Description
flow_id string Identifier of the Flow previously created.
inbound_flow_id string Inbound flow ID.
inbound_message string Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.
waba_phone_number string Phone number of the business WhatsApp (WABA) that interacts with the users. Must include the country code.

Create WABA subscription

This endpoint allows users to create a WhatsApp Business Account (WABA) subscription. Users can initiate and configure the subscription process by providing the necessary information to establish a connection or subscription with a WABA, facilitating communication and interaction with WhatsApp users.
post /v1/whatsapp/waba-subscription

object

OutputMessage

Field Type Description
message string Message

Provider Statuses

This endpoint receives and processes the status of a WhatsApp message from a WhatsApp provider. It enables system to handle and manage the status information associated with WhatsApp messages, facilitating effective monitoring and processing of message delivery and engagement.
Response
post /v1/whatsapp/{provider}/statuses

object

OutputMessage

Field Type Description
message string Message

Send Outbound Message

Sends an Outbound Message as a first interaction to an user. The Outbound Message status needs to be APPROVED before it can be sent.
Request
Request Body *application/x-www-form-urlencoded
country_code string

[Required] Country code for the user phone number. Example: +57

flow_id string

[Required] If the Outbound Message is_notification field is false. Contains the FlowID of the flow that will start when the Outbound message is accepted by the user.

Example: IPF123

outbound_id string

[Required] ID of an approved Outbound Message. Example: OTB123

phone_number string

[Required] Phone number without the country code of the user that will receive the message. Example: 0001234567

user_authorized boolean

[Required] Must be true for starting the conversation.

User has authorized to be contacted through WhatsApp.

var.<variable_name> string

[Required] If the outbound message has variables like hello {{.name}} {{.lastname}}. The value must be the desired value of the variable.

It is important to send as many key-value pairs as variables present in the message.

Example: for the first variable var.name: Roger and for the second variable var.lastname: Federer.

account_id string

This field is used as a unique identifier for your user in the Truora’ system. If you send it, outbound messages sent to each user will be linked through this. Note that only Account IDs following the regex pattern [a-zA-Z0-9_.-]+ are supported. Please go to Create an Account ID to learn more about it.

object

SendOutboundOutput

Field Type Description
flow_id string Identifier of the Flow that will start the conversation if the outbound is not a notification.
message string Info message indicating the outbound type and phone number for the message that was sent.
outbound_message object
client_id string Client ID
creation_date string Creation date
failure_reason string Failure reason
is_notification boolean Indicates whether the Outbound Message is a notification.
media_url string URL of the Outbound Message media.
outbound_answers array Outbound Message answers.
action string Indicates the action to perform when the user sends the answer.
Options: continue_process| cancel_process
message string Message sent in the outbound answer
outbound_id string Outbound message ID.
outbound_message string Outbound message content.
outbound_name string Name of the outbound.
outbound_status string Outbound Message status.
Options: APPROVED| PENDING| REJECTED
outbound_type string Type of the outbound message.
variable_mapping object The mapping of the variables present in the message
1 string var_1
2 string var_2
n string var_n
waba_phone_number string Phone number of the WABA line associated to the Outbound Message.
session_id string Identifier of the WhatsApp session started with the user.
user_phone_number string Phone number of the user that received the message.

Cancell Campaign

This endpoint offers the capability to cancel an active campaign. Users can initiate the cancellation process for a specific campaign, preventing further message deliveries and interactions. It provides a means to swiftly and effectively halt campaign activities when necessary.
post /v1/whatsapp/campaigns/{campaign_id}/cancel

object

OutputMessage

Field Type Description
message string Message

Create Inbound Flows

Set up inbound message that triggers a specific flow. All inputs are required for inbound creation.

To finish the inbound creation process, you must access the following link, by adding the PhoneNumber and the activating message. when you need to put a space in the activation message write this code %20

https://api.whatsapp.com/send/?phone=PhoneNumber&text=activatingmessage

Example https://api.whatsapp.com/send/?phone=57317770000&text=Hola%20Truora

Request
Request Body *application/x-www-form-urlencoded
flow_id string

Identifier of the Flow previously created.

inbound_message string

Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.

waba_phone_number string

Phone number of the WABA that interacts with the users. Must include the country code. Example 14080001111.

object

CreateInboundFlowOutput

Field Type Description
flow_id string Identifier of the Flow previously created.
inbound_flow_id string Inbound flow ID.
inbound_message string Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.
waba_phone_number string Phone number of the business WhatsApp (WABA) that interacts with the users. Must include the country code.

Create Outbound Messages

Creates an Outbound Message that allows to send messages to users as a first interaction. Outbound messages need to be approved before they can be used.
Request
Request Body *application/x-www-form-urlencoded
category enum
Allowed: TRANSACTIONAL | MARKETING | OTP

[Required] Enum defined by WhatsApp of the category for the outbound. OTP is for One Time Passwords, MARKETING is for marketing campaigns and TRANSACTIONAL is for any other topic of the Outbound.

continue_process_message string

Required If is_notification is set to False, it will be the content for the continue option in the outbound message.

is_notification boolean

[Required] Indicates if the Outbound Message is a notification (true) or will start a flow (false).

outbound_name string

[Required] Contains a text specifying the name of the outbound.

var.<variable_name> string

Required if the outbound message has variables like hello {{.name}} {{.lastname}}. The value must be an example of the variable.

It is important to send as many key-value pairs as variables present in the message.

Example: for the first variable var.name: Jhon and for the second variable var.lastname: Doe.

waba_phone_number string

[Required] WABA in which this outbound template will be added.

cancel_process_message string

Required If is_notification is set False, it will be the content for the cancel option in the outbound message.

language_code enum
Allowed: es | en

[Required] Code of the language the message is in.

media_url string

Required if the outbound type is not text.

template_type enum
Allowed: TEXT | VIDEO | IMAGE | DOCUMENT

[Required] Type of the outbound message.

supported content Image: image/jpeg, image/png maximum size 5mb. Video: video/mp4, video/3gpp maximum size 16mb. Document: any valid MIME type maximum size 100mb.

content string

[Required] The message to be sent to the user.

Example: โ€œHello, ยฟare you ready to start the process?โ€

If the message will include variables, they should be specified between double brackets like {{.<variable_name>}}.

Example: โ€œHello {{.name}}, ยฟare you ready to start the process?โ€

object

OutboundMessage

Field Type Description
client_id string Client ID
creation_date string Creation date
failure_reason string Failure reason
is_notification boolean Indicates whether the Outbound Message is a notification.
media_url string URL of the Outbound Message media.
outbound_answers array Outbound Message answers.
action string Indicates the action to perform when the user sends the answer.
Options: continue_process| cancel_process
message string Message sent in the outbound answer
outbound_id string Outbound message ID.
outbound_message string Outbound message content.
outbound_name string Name of the outbound.
outbound_status string Outbound Message status.
Options: APPROVED| PENDING| REJECTED
outbound_type string Type of the outbound message.
variable_mapping object The mapping of the variables present in the message
1 string var_1
2 string var_2
n string var_n
waba_phone_number string Phone number of the WABA line associated to the Outbound Message.

Update Outbound Message

Updates an Outbound Message that allows to send messages to users as a first interaction. Outbound messages need to be approved before they can be used.

object

OutboundMessage

Field Type Description
client_id string Client ID
creation_date string Creation date
failure_reason string Failure reason
is_notification boolean Indicates whether the Outbound Message is a notification.
media_url string URL of the Outbound Message media.
outbound_answers array Outbound Message answers.
action string Indicates the action to perform when the user sends the answer.
Options: continue_process| cancel_process
message string Message sent in the outbound answer
outbound_id string Outbound message ID.
outbound_message string Outbound message content.
outbound_name string Name of the outbound.
outbound_status string Outbound Message status.
Options: APPROVED| PENDING| REJECTED
outbound_type string Type of the outbound message.
variable_mapping object The mapping of the variables present in the message
1 string var_1
2 string var_2
n string var_n
waba_phone_number string Phone number of the WABA line associated to the Outbound Message.

Put WABA Line config

This endpoint provides the functionality to configure and customize the details of a WhatsApp Business Account (WABA) line. Users can modify various parameters and preferences to tailor the configuration of their WABA line according to their specific needs and preferences.
put /v1/whatsapp/lines/{waba_line}/config

object

WabaLine

Field Type Description
client_id string Client ID
waba_app_id string WABA Line app ID.
waba_app_name string WABA Line app name.
waba_phone_number string Phone number of the WABA line.
Path Parameters
default_flow_id string
[Optional]
The default_flow_id parameter is used to specify the ID of the default flow to be used in a WABA Line

List WABA Lines

This endpoint retrieves a list of WhatsApp Business (WABA) lines that have been assigned to a Truora account. It provides essential information about each WABA line, including line details, configuration settings, and associated data, allowing account holders to manage and monitor their WhatsApp Business lines efficiently.
get /v1/whatsapp/lines

object

WabaLinesList

Field Type Description
next string Path to the next page of results
self string Path to the current page of results
waba_lines array List of WABA lines
client_id string Client ID
waba_app_id string WABA Line app ID.
waba_app_name string WABA Line app name.
waba_phone_number string Phone number of the WABA line.

Get Result

Allows you to retrieve the current status and details of a process. The status begins as pending and updates to either success or failure when the process completes.

  • Pending: The process is still ongoing.
  • Success: All steps in the process have been successfully completed. If the flow includes validators, all validation_status values must also be successful.
  • Failure: Occurs due to an internal error, timeout, or if the process is declined or expired.

Here’s a comprehensive list of reasons why a process or validation might be declined or expired, as recorded in the declined_reason and expired_reason fields:

If a process includes validators and the identity process times out because a validation did not complete, but all inputs have been uploaded, the system grants an additional 5 minutes to receive a validation response with the final status. This behavior occurs up to 3 times.

On the final attempt to retrieve the validation response, if the validation remains in the pending status, the identity process status will update to failure, with failure_status set to expired.

If a process includes the attributes override_status and override_status_history, it means the final status was modified by an authorized user. In this case, use the override_status attribute instead of status to determine the final status of the process. The override_status_history attribute will contain the history of changes made to the status.

get /v1/processes/{process_id}/result

object

resultOutput

Field Type Description
account_id string Account ID
client_id string Client ID
client_user_id string Client User ID
country string Country for the validation
Options: CO| BR| MX| EC| ALL
failure_status string Defines the reason why the processes failed.
flow_id string ID of the identity flow
flow_version string Flow version
process_id string Process ID
status string process status
Options: success| failure| pending
validations array List of validations performed
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``. <a href=" https://developer.truora.com/products/digital-identity/declined_reasons.html ">Learn more about the reasons why the process may be declined.</a>
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: face-recognition| email-verification| phone-verification| document-validation| electronic-signature
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
process_id string
[Required]
The ID of the process for which results are being retrieved.

Get WABA Line

This endpoint provides the functionality to retrieve detailed information about a WhatsApp Business Account (WABA) line. Users can access essential data related to the WABA line’s configuration, contact information, messaging capabilities, and integration options, facilitating effective management and utilization of the WABA line.
get /v1/whatsapp/lines/{waba_line}

object

WabaLinesList

Field Type Description
next string Path to the next page of results
self string Path to the current page of results
waba_lines array List of WABA lines
client_id string Client ID
waba_app_id string WABA Line app ID.
waba_app_name string WABA Line app name.
waba_phone_number string Phone number of the WABA line.

Get Inbound Flow

This endpoint allows users to retrieve information about a previously created inbound. Users can access details and data related to a specific inbound.
get /v1/whatsapp/inbounds/{inbound_flow_id}

object

CreateInboundFlowOutput

Field Type Description
flow_id string Identifier of the Flow previously created.
inbound_flow_id string Inbound flow ID.
inbound_message string Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.
waba_phone_number string Phone number of the business WhatsApp (WABA) that interacts with the users. Must include the country code.
Path Parameters
inbound_flow_id string
[Required]
Unique identifier of inbound flows

List Outbound Messages

This endpoint retrieves a list of outbound messages that have been created. Users can access this endpoint to view and review the outbound messages they have generated or sent, providing an overview of the created outbound messages within the system or application.
Query Parameters
line string
[Required]
WhatsApp business account line (WABA). Do not forget that you must add the country code followed by the number. example: 1432567893

Get Outbound Message

This endpoint retrieves an outbound message. Users can use this endpoint to obtain details or content related to a specific outbound message.

object

OutboundMessage

Field Type Description
client_id string Client ID
creation_date string Creation date
failure_reason string Failure reason
is_notification boolean Indicates whether the Outbound Message is a notification.
media_url string URL of the Outbound Message media.
outbound_answers array Outbound Message answers.
action string Indicates the action to perform when the user sends the answer.
Options: continue_process| cancel_process
message string Message sent in the outbound answer
outbound_id string Outbound message ID.
outbound_message string Outbound message content.
outbound_name string Name of the outbound.
outbound_status string Outbound Message status.
Options: APPROVED| PENDING| REJECTED
outbound_type string Type of the outbound message.
variable_mapping object The mapping of the variables present in the message
1 string var_1
2 string var_2
n string var_n
waba_phone_number string Phone number of the WABA line associated to the Outbound Message.
Path Parameters
outbound_id string
[Required]
outbound ID

List Inbound Flows

This endpoint allows users to retrieve a list of created inbound flows. Users can access information about each inbound flow.
get /v1/whatsapp/inbounds

object

InboundFlowList

Field Type Description
inbound_flows array List of inbound flows found
flow_id string Identifier of the Flow previously created.
inbound_flow_id string Inbound flow ID.
inbound_message string Unique message the users will be sending to the business WhatsApp (WABA) in order to begin the Flow.
waba_phone_number string Phone number of the business WhatsApp (WABA) that interacts with the users. Must include the country code.
next string Path to the next page of results
self string Path to the current page of results
Query Parameters
start_key string
[Optional]
[Optional] start key value for pagination, if you want to go to the previous or next page.

Get Campaign

This endpoint provides the functionality to retrieve detailed information about a specific campaign. Users can access comprehensive data related to the campaign.
get /v1/whatsapp/campaigns/{campaign_id}

object

Campaign

Field Type Description
batch_id string Unique identifier for the batch of messages sent in the campaign
campaign_id string Unique identifier for the campaign
campaign_name string Name given to the campaign
campaign_status string Current status of the campaign
Options: scheduled| in_progress| sent| error
campaign_type string Type of campaign
Options: manual| continuous
client_id string Unique identifier for the client associated with the campaign
creation_date string Date and time when the campaign was created
delivered_users integer Number of users who have received the campaign messages successfully
engaged_users integer Number of users who have actively engaged or interacted with the campaign
failed_deliveries integer Number of deliveries that failed to be delivered
flow_id string Unique identifier for the flow used in the campaign
invalid_deliveries integer Number of deliveries that were determined to be invalid or unsuccessful
outbound_id string Unique identifier for the outbound message associated with the campaign
recipients integer Total number of recipients targeted in the campaign
sending_date string Date and time when the campaign is scheduled for sending
update_date string Date and time when the campaign was last updated
waba_phone_number string WhatsApp Business API phone number used for the campaign
Path Parameters
campaign_id string
[Optional]
Unique identifier for the campaign

Get Process Validations

This API endpoint allows you to retrieve the current state and information of the process validations.
Response
get /v1/processes/{process_id}/validations

object

resultOutput

Field Type Description
account_id string Account ID
client_id string Client ID
client_user_id string Client User ID
country string Country for the validation
Options: CO| BR| MX| EC| ALL
failure_status string Defines the reason why the processes failed.
flow_id string ID of the identity flow
flow_version string Flow version
process_id string Process ID
status string process status
Options: success| failure| pending
validations array List of validations performed
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``. <a href=" https://developer.truora.com/products/digital-identity/declined_reasons.html ">Learn more about the reasons why the process may be declined.</a>
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: face-recognition| email-verification| phone-verification| document-validation| electronic-signature
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure

List WABAs

This endpoint retrieves a list of WhatsApp Business Accounts that have been assigned to a Truora account.
Response
get /v1/whatsapp/wabas

object

WabaLinesList

Field Type Description
next string Path to the next page of results
self string Path to the current page of results
waba_lines array List of WABA lines
client_id string Client ID
waba_app_id string WABA Line app ID.
waba_app_name string WABA Line app name.
waba_phone_number string Phone number of the WABA line.

Remove Inbound Flow

This endpoint allows users to remove inbound flows. Users can initiate the removal process for specific inbound flows, effectively eliminating them from the system. It provides a means to manage and clean up inbound flows when they are no longer needed or relevant.
delete /v1/whatsapp/inbounds/{inbound_flow_id}

object

OutputMessage

Field Type Description
message string Message

Remove Outbound Message

This endpoint allows users to delete an outbound message. Users can initiate the removal process for a specific outbound message, effectively eliminating it from the system or application. It provides a means to manage and clean up outbound messages when they are no longer needed or relevant.
delete /v1/whatsapp/outbounds/{outbound_id}

object

OutputMessage

Field Type Description
message string Message

WA Contacts

Add, search and manage your customers (end users) in a single place.

Create contact property

This endpoint is used to create a new contact property with data like its name and type. NOTE: A maximum of 25 visible (non-hidden) properties can exist simultaneously.
Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: string | int | boolean | date | email | enum

Indicates the type of the custom property.

name string
[Required]

Indicates the name of the custom property.

config_values.allowed_values enum
Allowed: value1 | value2 | value3

Required only if type is enum. Add the list of personalized values separated by comma, example: value1, value2, value3.

is_hidden boolean

When set to true, this setting hides the property being created, ensuring it does not appear in a contact’s details. NOTE: A maximum of 25 visible (non-hidden) properties can exist simultaneously.

Response
post /v1/contact-properties

object

OutputMessage

Field Type Description
message string Message

Create contact

This endpoint is used to create a new contact with data like its phone number, name, and optional email and values for custom contact properties.
Request
Request Body *application/x-www-form-urlencoded
phone_number string
[Required]

Indicates the Phone number of the contact that you want to register. Must include the country code (e.g., +570000000000).

name string
[Required]

Indicates the name of the contact that you want to register.

custom_property_values.{{property_id}} string

Indicates the custom property. You must replace the variable {{property_id}}, with the id of the property you want to set for the contact. (e.g., custom_property_values.CCP12345).

email string

Indicates the email address you want to register (e.g., email@yourdomain.com).

Response
post /v1/contacts

object

OutputMessage

Field Type Description
message string Message

Update contact

This endpoint is used to update a specific contact with the ID provided as a path parameter. The contact’s name, email and custom property values can be changed. An optional “emit_sysevent” body parameter can be passed so that the update triggers a sysevent.
Request
Request Body *application/x-www-form-urlencoded
custom_property_values.{{property_id}} string

Indicates the custom property. You must replace the variable {{property_id}}, with the id of the property you want to update for the contact. (e.g., custom_property_values.CCP12345).

email string

Indicates the email address you want to update (e.g., email@yourdomain.com).

name string

Indicates the name of the contact that you want to update.

Response
put /v1/contacts/{contact_id}

object

OutputMessage

Field Type Description
message string Message
Path Parameters
contact_id string
[Required]
The unique identifier of the contact to update.

Get contact properties

This endpoint is used to list pages of contact properties created in our platform. An optional “start_key” query parameter can be passed to continue pagination.
Response
get /v1/contact-properties

object

OutputMessage

Field Type Description
message string Message

Get all contacts

This endpoint is used to list pages of contacts created in our platform. An optional “start_key” query parameter can be passed to continue pagination.
Response
get /v1/contacts

object

OutputMessage

Field Type Description
message string Message

Get contact

This endpoint is used to get the data related to a specific contact with the ID provided as a path parameter.
Response
get /v1/contacts/{contact_id}

object

OutputMessage

Field Type Description
message string Message
Path Parameters
contact_id string
[Required]
The unique identifier of the contact to retrieve.

Delete contact

This endpoint is used to delete a specific contact with the ID provided as a path parameter.
Response
delete /v1/contacts/{contact_id}

object

OutputMessage

Field Type Description
message string Message
Path Parameters
contact_id string
[Required]
The unique identifier of the contact to delete.

DI Processes

Configure and order the validations you want to do in your process. Try and start validating your users by sending a link.

Create Identity

This endpoint allows you to initiate an identity validation process for a specific user. Before using this endpoint, you must create a Flow and generate a temporary api_key linked to the corresponding flow_id. Follow the Web Integration Token Guide to complete this setup. The response will include a process_id, which you’ll use in subsequent process requests.

Important Notes

Token:

You must generate a unique token (api_key) for each identity validation process, even if performed by the same user.

Header Setup:

Set the Truora-API-Key header to the value of the generated token (api_key) required before making this request.

post /v1/processes

object

IdentityProcessResponse

Field Type Description
cell_phone string Cell phone number
client_id string ID of the client creating the identity
client_user_id string ID of the client user creating the identity
country string Country of origin
Options: co| ve| cl| mx| pe| do| sv| gt| bo| cr| ec| pa| br| all
creation_date string Creation date
Format: date
current_step integer Step being currently processed in the identity validation process
date_of_birth string Date of birth
Format: date
documents array Lists information of the documents created for the identity process. Only for processes that include the document verification
document_id string Document ID
email string email
error_message string Error message displayed in case something goes wrong
failure_status string Defines the reason why the identity process failed. ``system_error`` means an error occurred while processing the identity process, ``expired`` means the identity process took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validations of the identity process. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
first_name string First name
gender string Gender
last_name string Last name
process_id string Process ID
redirect_url string URL that the user will be redirected to when the process finishes. We will redirect to this URL with the client_user_id and the process_id as query parameters
status string Indicates whether the identity process was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the process is still ongoing
Options: failure| success| pending
steps array List of steps to be taken in order to process the identity validation
async_step boolean Indicates whether the user interface moves on to the next step while the current validation is being completed rather than waiting for every validation to finish before showing the next step interface
expected_inputs array List of inputs that are to be expected by this step
description string Input description
length integer Input character length
name string Input name
placeholder string Input placeholder
read_only boolean Indicates whether the input is read only
type string Input type
value string Input value
type string Validation step type
Options: enter_authorization| enter_captcha| enter_email
update_date string Latest update date
Format: date

Identity Back

This request allows the user to navigate one step back in the identity validation process.
Response
post /v1/processes/{process_id}/back

object

IdentityProcessResponse

Field Type Description
cell_phone string Cell phone number
client_id string ID of the client creating the identity
client_user_id string ID of the client user creating the identity
country string Country of origin
Options: co| ve| cl| mx| pe| do| sv| gt| bo| cr| ec| pa| br| all
creation_date string Creation date
Format: date
current_step integer Step being currently processed in the identity validation process
date_of_birth string Date of birth
Format: date
documents array Lists information of the documents created for the identity process. Only for processes that include the document verification
document_id string Document ID
email string email
error_message string Error message displayed in case something goes wrong
failure_status string Defines the reason why the identity process failed. ``system_error`` means an error occurred while processing the identity process, ``expired`` means the identity process took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validations of the identity process. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
first_name string First name
gender string Gender
last_name string Last name
process_id string Process ID
redirect_url string URL that the user will be redirected to when the process finishes. We will redirect to this URL with the client_user_id and the process_id as query parameters
status string Indicates whether the identity process was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the process is still ongoing
Options: failure| success| pending
steps array List of steps to be taken in order to process the identity validation
async_step boolean Indicates whether the user interface moves on to the next step while the current validation is being completed rather than waiting for every validation to finish before showing the next step interface
expected_inputs array List of inputs that are to be expected by this step
description string Input description
length integer Input character length
name string Input name
placeholder string Input placeholder
read_only boolean Indicates whether the input is read only
type string Input type
value string Input value
type string Validation step type
Options: enter_authorization| enter_captcha| enter_email
update_date string Latest update date
Format: date
Path Parameters
process_id string
[Required]
The ID of the ongoing process.

List Identity

Retrieves the current status and details of all identity processes. Query parameters can be used to filter results based on specific criteria. When a date range is defined, the search is limited to 2 months. The response includes up to 20 processes per query.

Note: If a process includes the attributes override_status and override_status_history, it means the final status was modified by an authorized user. In this case, use the override_status attribute instead of status to determine the final status of the process. The override_status_history attribute will contain the history of changes made to the status.

get /v1/processes

object

IdentityProcessResponse

Field Type Description
cell_phone string Cell phone number
client_id string ID of the client creating the identity
client_user_id string ID of the client user creating the identity
country string Country of origin
Options: co| ve| cl| mx| pe| do| sv| gt| bo| cr| ec| pa| br| all
creation_date string Creation date
Format: date
current_step integer Step being currently processed in the identity validation process
date_of_birth string Date of birth
Format: date
documents array Lists information of the documents created for the identity process. Only for processes that include the document verification
document_id string Document ID
email string email
error_message string Error message displayed in case something goes wrong
failure_status string Defines the reason why the identity process failed. ``system_error`` means an error occurred while processing the identity process, ``expired`` means the identity process took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validations of the identity process. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
first_name string First name
gender string Gender
last_name string Last name
process_id string Process ID
redirect_url string URL that the user will be redirected to when the process finishes. We will redirect to this URL with the client_user_id and the process_id as query parameters
status string Indicates whether the identity process was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the process is still ongoing
Options: failure| success| pending
steps array List of steps to be taken in order to process the identity validation
async_step boolean Indicates whether the user interface moves on to the next step while the current validation is being completed rather than waiting for every validation to finish before showing the next step interface
expected_inputs array List of inputs that are to be expected by this step
description string Input description
length integer Input character length
name string Input name
placeholder string Input placeholder
read_only boolean Indicates whether the input is read only
type string Input type
value string Input value
type string Validation step type
Options: enter_authorization| enter_captcha| enter_email
update_date string Latest update date
Format: date
Query Parameters
declined_reason string
[Optional]
Filters processes by a Declined Reason. Multiple declined_reason parameters can be used to filter results by more than one reason.
end_date string
[Optional]
Specifies the end of the date range for filtering processes. Must be in the ISO 8601 format (YYYY-MM-DDTHH:MM:SSยฑhh:mm). When used, the range between start_date and end_date cannot exceed 2 months. Both start_date and end_date are required for date range filtering.
failure_status string
[Optional]
Filters processes by their failure status, such as expired or pending.
search string
[Optional]
Filters results by matching the provided value against specific fields. For process_id and flow_id, an exact match is required. For other fields, such as account_id, document_number, cell_phone, first_name, and last_name, partial matches are supported. Provide only the value to search for; specifying the field name will not work.
start_date string
[Optional]
Specifies the start of the date range for filtering processes. Must be in the ISO 8601 format (YYYY-MM-DDTHH:MM:SSยฑhh:mm). When used, the range between start_date and end_date cannot exceed 2 months. Both start_date and end_date are required for date range filtering.
start_key string
[Optional]
Specifies the starting key value for pagination. Use this parameter after the first query if more results are available for pagination.
status string
[Optional]
Filters processes by their status: pending, failure, or success.

Read Identity

Retrieves the current status and detailed results of the specified identity process, including the progress of each step.
Response
get /v1/processes/{process_id}

object

IdentityProcessResponse

Field Type Description
cell_phone string Cell phone number
client_id string ID of the client creating the identity
client_user_id string ID of the client user creating the identity
country string Country of origin
Options: co| ve| cl| mx| pe| do| sv| gt| bo| cr| ec| pa| br| all
creation_date string Creation date
Format: date
current_step integer Step being currently processed in the identity validation process
date_of_birth string Date of birth
Format: date
documents array Lists information of the documents created for the identity process. Only for processes that include the document verification
document_id string Document ID
email string email
error_message string Error message displayed in case something goes wrong
failure_status string Defines the reason why the identity process failed. ``system_error`` means an error occurred while processing the identity process, ``expired`` means the identity process took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validations of the identity process. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
first_name string First name
gender string Gender
last_name string Last name
process_id string Process ID
redirect_url string URL that the user will be redirected to when the process finishes. We will redirect to this URL with the client_user_id and the process_id as query parameters
status string Indicates whether the identity process was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the process is still ongoing
Options: failure| success| pending
steps array List of steps to be taken in order to process the identity validation
async_step boolean Indicates whether the user interface moves on to the next step while the current validation is being completed rather than waiting for every validation to finish before showing the next step interface
expected_inputs array List of inputs that are to be expected by this step
description string Input description
length integer Input character length
name string Input name
placeholder string Input placeholder
read_only boolean Indicates whether the input is read only
type string Input type
value string Input value
type string Validation step type
Options: enter_authorization| enter_captcha| enter_email
update_date string Latest update date
Format: date
Path Parameters
process_id string
[Required]
The ID of the process to retrieve.

Download PDF

Allows to retrieve the pdf of a process or generates one if it doesn’t exist already
get /v1/processes/{process_id}/pdf

object

ProcessPDFStatus

Field Type Description
file_status string The status of the process pdf file when it's requested for download
Options: requested| in_progress
Path Parameters
process_id string
[Required]
The ID of the generated and finished process that it’s required to be download as a pdf

Get Result

Allows you to retrieve the current status and details of a process. The status begins as pending and updates to either success or failure when the process completes.

  • Pending: The process is still ongoing.
  • Success: All steps in the process have been successfully completed. If the flow includes validators, all validation_status values must also be successful.
  • Failure: Occurs due to an internal error, timeout, or if the process is declined or expired.

Here’s a comprehensive list of reasons why a process or validation might be declined or expired, as recorded in the declined_reason and expired_reason fields:

If a process includes validators and the identity process times out because a validation did not complete, but all inputs have been uploaded, the system grants an additional 5 minutes to receive a validation response with the final status. This behavior occurs up to 3 times.

On the final attempt to retrieve the validation response, if the validation remains in the pending status, the identity process status will update to failure, with failure_status set to expired.

If a process includes the attributes override_status and override_status_history, it means the final status was modified by an authorized user. In this case, use the override_status attribute instead of status to determine the final status of the process. The override_status_history attribute will contain the history of changes made to the status.

get /v1/processes/{process_id}/result

object

resultOutput

Field Type Description
account_id string Account ID
client_id string Client ID
client_user_id string Client User ID
country string Country for the validation
Options: CO| BR| MX| EC| ALL
failure_status string Defines the reason why the processes failed.
flow_id string ID of the identity flow
flow_version string Flow version
process_id string Process ID
status string process status
Options: success| failure| pending
validations array List of validations performed
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``. <a href=" https://developer.truora.com/products/digital-identity/declined_reasons.html ">Learn more about the reasons why the process may be declined.</a>
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: face-recognition| email-verification| phone-verification| document-validation| electronic-signature
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
process_id string
[Required]
The ID of the process for which results are being retrieved.

Read Variables

Retrieves all the variables associated with the specified identity process, including their names and current values.
Response
get /v1/processes/{process_id}/variables

object

UnauthorizedError

Field Type Description
message string Used to notify error message
Path Parameters
process_id string
[Required]
The ID of the process from which to retrieve the variables.

Customers

Customers is a centralized solution that allows you to visualize and analyze the data generated by the transactions made by your users along different business funnels.

List Customers

This API endpoint allows retrieving the current status and general information of all customers associated with an account.
get /v1/customers

object

UserProfilesOutput

Field Type Description
customers array List of customers
birthday string Date of birth
Format: date
country string Country of origin
Options: co| ve| cl| mx| pe| do| sv| gt| bo| cr| ec| pa| br| all
document_front_url string URL of the front photo of the customer's document
document_issue_date string Date of issue of customer document
Format: date
document_number string Customer document ID
document_reverse_url string URL of the reverse photo of the customer's document
document_type string Document type associated with the Customer
Options: national-id| foreign-id| passport
email string email
face_image_url string URL of the photo of the customer's face photo
gender string Customer gender
Options: female| male
id string Customer ID
invoice_url string URL of the document invoice image
latest_transactions array List of the last transactions performed by the customer
date string Transaction date
Format: date
source string Product that originated the transaction
Options: check| process| validation| engagement-chat
status string Transaction status. Depends on the source. For check: โ€œnot_startedโ€, โ€œin_progressโ€, โ€œcompletedโ€, โ€œexpiredโ€, โ€œerrorโ€, โ€œdelayedโ€, โ€œskippedโ€. For process or validation: โ€œpendingโ€, โ€œsuccessโ€, โ€œfailureโ€
Options: failure| success| pending| not_started| in_progress| completed| expired| error| delayed| skipped
transaction_id string Transaction ID
type string Transaction type. Depends on the source. For check: โ€œpersonโ€. For validation: โ€œfacial recognitionโ€, โ€œe-mail verificationโ€, โ€œtelephone verificationโ€, โ€œdocument validationโ€, โ€œcompany-dataโ€, โ€œface searchโ€, โ€œelectronic signatureโ€
Options: face-recognition| email-verification| phone-verification| document-validation| enterprise-data| face-search| electronic-signature| person
name string Customer name
phone string Cell phone number
next string Path to next
self string Path to self
Query Parameters
search string
[Optional]
Filter the list of customers by document-id, email, name and phone number
start_key string
[Optional]
Start key value for the pagination.

Get Customer

This API endpoint allows retrieving the details of the customer identified by the provided ID.
get /v1/customers/{customer_id}

object

UnauthorizedError

Field Type Description
message string Used to notify error message
Path Parameters
customer_id string
[Required]
The customer ID is an automatically generated ID and is unique for each customer

List Customers Transactions

List customer transactions endpoint allows you to consult the detailed information of the transactions associated with a customer.
get /v1/customers/{customer_id}/transactions

object

UserProfileTransactionsOutput

Field Type Description
customers array List of customers
account_id string Account ID
creation_date string Transaction creation date
Format: date
declined_reason string Describes the declined reason only for processes or validations
devices_info array Info of the devices on which the transaction was performed with source process
failure_status string Describes the failure status only for processes or validations
Options: canceled| expired| system_error| declined
profile_id string Profile ID
properties object Transaction creation date
created_via string
document_check_id string ID of the check that is performed with document validation
document_check_url string URL of the check that is performed with document validation
flow_id string ID of the flow used for the transaction with source process
flow_version string Version of the flow used for transaction with source process
ip_address string IP address of the device on which a transaction with source validation has been performed
is_used string Determines if the flow that was used for the process was used
signed_document_url string URL of the document to be signed in the electronic_signature validation
source string Product that originated the transaction
Options: check| process| validation| engagement-chat
status string Transaction status. Depends on the source. For check: โ€œnot_startedโ€, โ€œin_progressโ€, โ€œcompletedโ€, โ€œexpiredโ€, โ€œerrorโ€, โ€œdelayedโ€, โ€œskippedโ€. For process or validation: โ€œpendingโ€, โ€œsuccessโ€, โ€œfailureโ€
Options: failure| success| pending| not_started| in_progress| completed| expired| error| delayed| skipped
transaction_id string Transaction ID
type string Transaction type. Depends on the source. For check: โ€œpersonโ€. For validation: โ€œfacial recognitionโ€, โ€œe-mail verificationโ€, โ€œtelephone verificationโ€, โ€œdocument validationโ€, โ€œcompany-dataโ€, โ€œface searchโ€, โ€œelectronic signatureโ€
Options: face-recognition| email-verification| phone-verification| document-validation| enterprise-data| face-search| electronic-signature| person
update_date string Transaction update date
Format: date
validations array List of validations performed by the customer for this transaction with source process
date string Transaction date
Format: date
source string Product that originated the transaction
Options: check| process| validation| engagement-chat
status string Transaction status. Depends on the source. For check: โ€œnot_startedโ€, โ€œin_progressโ€, โ€œcompletedโ€, โ€œexpiredโ€, โ€œerrorโ€, โ€œdelayedโ€, โ€œskippedโ€. For process or validation: โ€œpendingโ€, โ€œsuccessโ€, โ€œfailureโ€
Options: failure| success| pending| not_started| in_progress| completed| expired| error| delayed| skipped
transaction_id string Transaction ID
type string Transaction type. Depends on the source. For check: โ€œpersonโ€. For validation: โ€œfacial recognitionโ€, โ€œe-mail verificationโ€, โ€œtelephone verificationโ€, โ€œdocument validationโ€, โ€œcompany-dataโ€, โ€œface searchโ€, โ€œelectronic signatureโ€
Options: face-recognition| email-verification| phone-verification| document-validation| enterprise-data| face-search| electronic-signature| person
next string Path to next
self string Path to self
Path Parameters
customer_id string
[Required]
The customer ID is an automatically generated ID and is unique for each customer
Query Parameters
source string
[Optional]
Allowed: check | process | validation | engagement-chat

Product that originated the transaction.
start_key string
[Optional]
Start key value for the pagination.

Read Customer Transaction

Read customer transaction endpoint allows you to consult the detailed information of a transaction associated with a customer.
get /v1/customers/{customer_id}/transactions/{transaction_id}

object

UserProfileTransactionResponse

Field Type Description
account_id string Account ID
creation_date string Transaction creation date
Format: date
declined_reason string Describes the declined reason only for processes or validations
devices_info array Info of the devices on which the transaction was performed with source process
failure_status string Describes the failure status only for processes or validations
Options: canceled| expired| system_error| declined
profile_id string Profile ID
properties object Transaction creation date
created_via string
document_check_id string ID of the check that is performed with document validation
document_check_url string URL of the check that is performed with document validation
flow_id string ID of the flow used for the transaction with source process
flow_version string Version of the flow used for transaction with source process
ip_address string IP address of the device on which a transaction with source validation has been performed
is_used string Determines if the flow that was used for the process was used
signed_document_url string URL of the document to be signed in the electronic_signature validation
source string Product that originated the transaction
Options: check| process| validation| engagement-chat
status string Transaction status. Depends on the source. For check: โ€œnot_startedโ€, โ€œin_progressโ€, โ€œcompletedโ€, โ€œexpiredโ€, โ€œerrorโ€, โ€œdelayedโ€, โ€œskippedโ€. For process or validation: โ€œpendingโ€, โ€œsuccessโ€, โ€œfailureโ€
Options: failure| success| pending| not_started| in_progress| completed| expired| error| delayed| skipped
transaction_id string Transaction ID
type string Transaction type. Depends on the source. For check: โ€œpersonโ€. For validation: โ€œfacial recognitionโ€, โ€œe-mail verificationโ€, โ€œtelephone verificationโ€, โ€œdocument validationโ€, โ€œcompany-dataโ€, โ€œface searchโ€, โ€œelectronic signatureโ€
Options: face-recognition| email-verification| phone-verification| document-validation| enterprise-data| face-search| electronic-signature| person
update_date string Transaction update date
Format: date
validations array List of validations performed by the customer for this transaction with source process
date string Transaction date
Format: date
source string Product that originated the transaction
Options: check| process| validation| engagement-chat
status string Transaction status. Depends on the source. For check: โ€œnot_startedโ€, โ€œin_progressโ€, โ€œcompletedโ€, โ€œexpiredโ€, โ€œerrorโ€, โ€œdelayedโ€, โ€œskippedโ€. For process or validation: โ€œpendingโ€, โ€œsuccessโ€, โ€œfailureโ€
Options: failure| success| pending| not_started| in_progress| completed| expired| error| delayed| skipped
transaction_id string Transaction ID
type string Transaction type. Depends on the source. For check: โ€œpersonโ€. For validation: โ€œfacial recognitionโ€, โ€œe-mail verificationโ€, โ€œtelephone verificationโ€, โ€œdocument validationโ€, โ€œcompany-dataโ€, โ€œface searchโ€, โ€œelectronic signatureโ€
Options: face-recognition| email-verification| phone-verification| document-validation| enterprise-data| face-search| electronic-signature| person
Path Parameters
customer_id string
[Required]
The customer ID is an automatically generated ID and is unique for each customer
transaction_id string
[Required]
The transaction ID is the unique identifier of the transaction.

Main Validator Suite API

NOTE: Truora provides a Postman collection online that includes the necessary tools to simplify the testing process.

Welcome to the Truora Validators Suite RESTful API Reference. If you haven’t already, we strongly advise you to check out our Validators API Documentation.

Here, you’ll find detailed technical information about our Validators API endpoints, including parameters, request and response formats, error codes, and supported methods for seamless integration.

The Validators Suite supports various use cases, such as document validation, phone and email verification, facial recognition, and more.

A validation process may include some or all of the following steps, depending on the validator:

  • Create Enrollment: Required to associate user data for validators requiring prior information, such as face, email, and phone.

  • Create Validation: Required for all validators; you must specify the validator type and relevant validation parameters.

  • Perform Validation: Executes asynchronous validations, such as email or phone, by verifying tokens received by the user.

  • Get Validation: Retrieves the final status, results, and details of any validation.

Please keep in mind that in our validation processes, the Account ID serves as a unique user identifier, allowing you to track the validations performed. It is important to generate a distinct identifier for each user undergoing validation to prevent data overlap between users and ensure proper monitoring for each one.

For conceptual overviews, implementation guides for each validator, and additional resources to enhance your integration experience, please visit our Validators API Documentation.

Authentication

To access Truora’s services and perform API calls securely, you need to authenticate your requests. This is done by including a specific authentication token, known as the โ€Truora-API-Keyโ€ in the header of your requests.

By providing this key in your API requests, you establish a secure and authorized connection, enabling seamless interaction with Truora’s services.

  • If you haven’t already, sign up for a free account here before generating your Truora-API-Key.
  • Learn how to generate your Truora-API-Key here.
Base URL

https://api.validations.truora.com

Accounts

Validation accounts simplify user identification across multiple Truora validators, enabling a single user to undergo various validation methods using the same account. For better user tracking, it is recommended to create custom-named validation accounts and use them during the validation or enrollment processes; otherwise , if a custom account_id is not specified during these processes, validators will automatically assign a random alphanumeric name.

Create validation account

Creates a new validation account. This validation account is used to easily keep track of the validations made by a specific user.
Request
Request Body *application/x-www-form-urlencoded
document_expedition_date string

Person document issue date. RFC3339 format

document_type enum
Allowed: national-id | foreign-id | pep | passport

Person document type

phone_number string

Person phone number

facebook_user string

Person Facebook username

first_name string

Person first name

last_name string

Person last name

twitter_user string

Person Twitter username

country enum
Allowed: co | cl | mx | pe | do | sv | gt | br

Country where this person is located

document_number string

Person document number

email string

Person e-mail address

Response
post /v1/accounts

object

Account

Field Type Description
account_id string Validation account ID
country string Validation account country
creation_date string Account creation date. RFC3339 format
Format: date
document_expedition_date string Document issue date. RFC3339 format
Format: date
document_type string Person document type
email string Person e-mail address
facebook_user string Person Facebook username
first_name string Person first name
last_name string Person last name
national_id string Person ID number
phone_number string Person phone number
twitter_user string Person Twitter username

List validation accounts

Returns all the validation accounts that have been created for the user. A validation account is useful to be able to keep track of all validations performed by a single user.
Response
get /v1/accounts

object

CreatedAccounts

Field Type Description
accounts array Account list
account_id string Validation account ID
country string Validation account country
creation_date string Account creation date. RFC3339 format
Format: date
document_expedition_date string Document issue date. RFC3339 format
Format: date
document_type string Person document type
email string Person e-mail address
facebook_user string Person Facebook username
first_name string Person first name
last_name string Person last name
national_id string Person ID number
phone_number string Person phone number
twitter_user string Person Twitter username
next string Path to next page
self string Path to current page

Get validation account

Returns the validation account identified by the ID provided. This validation account represents a single user on the validation system
Response
get /v1/accounts/{account_id}

object

Account

Field Type Description
account_id string Validation account ID
country string Validation account country
creation_date string Account creation date. RFC3339 format
Format: date
document_expedition_date string Document issue date. RFC3339 format
Format: date
document_type string Person document type
email string Person e-mail address
facebook_user string Person Facebook username
first_name string Person first name
last_name string Person last name
national_id string Person ID number
phone_number string Person phone number
twitter_user string Person Twitter username
Path Parameters
validation_account_id string
[Required]
Validation account ID

Get Enrollments by Account

Retrieve all enrollments associated with a specific account_id. These enrollment objects include their status, and other information
Response
get /v1/accounts/{account_id}/enrollments

object

GetEnrollments

Field Type Description
enrollments array History of all the enrollments made on the account
account_id string
creation_date string
enrollment_id string
status string
update_date string
validation_type string
validator_data object have the additional information that gives the validators
next string Path to the next page
self string Path to the current page

Enrollments

The enrollment step is crucial in our system, as it connects an account with a specific validation type. This process allows you to register a user once and perform multiple validations seamlessly. The required fields for an enrollment vary depending on the validation type. Note that enrollment is mandatory for all validators except document validation.

Create Enrollment

This is the first step in validation processes like Face Search, Face, Phone, and Email validation. It requires the submission of necessary images or base information. During enrollment, essential materials, such as photographs or other relevant data, are collected to serve as the basis for user verification. It is important to emphasize that the actual validation will take place in later steps, using the information gathered during this stage. This step is crucial to ensure the system has all the necessary elements to perform an accurate and effective evaluation in subsequent stages.
Request
Request Body *application/x-www-form-urlencoded
user_authorized boolean
[Required]

This indicates that you have the authorization of the person to be enrolled. This is mandatory in order to comply with data protection laws. Value must be set to true in order to perform the enrollment.

type enum
[Required]
Allowed: face-recognition | email-verification | phone-verification | face-search

Indicates the type of validation to be performed along with this enrollment.

fraud_reason enum
Allowed: manipulated_document | manipulated_photo | non_payment | criminal_records_in_company | fraudster

[Required for face-search] Indicates the reason to block a face. Set one of the following:

  • manipulated_document: Indicates that this person is known to use manipulated documents to pass identity validations.

  • manipulated_photo: Indicates that this person is known to manipulate photos to pass identity validations.

  • non_payment: Indicates that this person has incomplete payments and refuses to pay.

  • criminal_records_in_company: Indicates that this person has some sort of criminal history with your company, or an ally.

  • fraudster: Indicates you know this person to be a fraudster for reasons different from the above.

confirmation enum
Allowed: none

Only available for face-recognition validations. Used to specify the creation of enrollment that does not require an identity validation to complete. Set as none to skip the required validation. If omitted, the enrollment will require the normal validation process, and the enrollment status will remain pending until successfully validated.

Note: To use the confirmation parameter your company’s account must be authorized. To request authorization, please contact our Support Team. This authorization will affect only your Truora-API-Keys created after the approval.

email string

[Required for email-verification] Email to be associated with the user account.

phone_number string

[Required for phone-verification] Phone number to be associated with the validation account on successful validation. Must include the country code (e.g., +57300XXXXXXX).

phone_type enum
Allowed: home | office | recover

[Required for phone-verification] Specifies the label of the phone number to be associated with the validation account upon successful validation. You can associate up to three phone numbers with a user account. To do this, you must create a new enrollment by choosing a different phone_type each time.

account_id string

Account ID linked to the enrollment.
An account ID is automatically created if omitted; otherwise, the custom account ID provided is used.
The account ID helps trace enrollments/validations linked to the account. Only account IDs matching the pattern [a-zA-Z0-9_.-]+ are supported. Learn more at Create an Account ID.

country string

[Optional* for phone-verification] Origin country of the person to be validated. *Required if it was not provided during account creation.

  • Allowed: CO | CL | MX | BR | VE | PE | EC | AR | US

[Required for face-search] Country of the reported face. Use ALL when using TruFace (face-search) as a Face Validation compliment.

  • Allowed: ALL | BR | CL | CO | CR | EC | MX | PE

Query Parameters
account_id string
[Optional]
Validation account ID. If left empty, a new validation account will be created

Get Enrollments by Account

Retrieve all enrollments associated with a specific account_id. These enrollment objects include their status, and other information
Response
get /v1/accounts/{account_id}/enrollments

object

GetEnrollments

Field Type Description
enrollments array History of all the enrollments made on the account
account_id string
creation_date string
enrollment_id string
status string
update_date string
validation_type string
validator_data object have the additional information that gives the validators
next string Path to the next page
self string Path to the current page

Get Enrollment

Allows searching for an enrollment in order to verify its progress, this step is optional. The enrollment status begins as pending and can ultimately result in either success or failure.

To learn more about the reasons for failure, please refer to the following guides:

Response
get /v1/enrollments/{enrollment_id}

object

Enrollment

Field Type Description
account_id string
creation_date string
enrollment_id string
status string
update_date string
validation_type string
validator_data object have the additional information that gives the validators
Path Parameters
enrollment_id string
[Required]
Enrollment ID to search.

Delete enrollment

Deletes an enrollment. If this endpoint is executed on an enrollment ID, the enrollment will be removed from the client’s account.
delete /v1/enrollments/{enrollment_id}

object

Error

Field Type Description
code number Error code
message string Message describing the error
Path Parameters
enrollment_id string
[Required]
Enrollment ID to be removed from the client’s account.

Validations

Validations is your tool for managing various validators such as document validation, face recognition, face search (TruFace), email verification, and phone verification. This API handles all the necessary logic for these validators, offering a unified service to manage multiple validators efficiently.

Create new validation with account

Creates a new validation for the validation account. Check out our Guide on Liveness test to learn more about this feature.

Note: You need the account_id from the first step and If you had already created an enrollment, it is not necessary to create one again for each validation.

Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: document-validation | face-recognition | email-verification | phone-verification | face-search

Indicates the type of validation to be performed.

user_authorized boolean
[Required]

This indicates that you have the authorization of the person to be verified. This is mandatory in order to comply with data protection laws. Value must be set to true in order to perform the validation.

account_id string
[Required]

Account ID linked to the validation.
For document-validation, an account ID is automatically created if omitted; otherwise, the custom account ID provided is used.
For other validations, use the same account ID from the enrollment process.
The account ID helps trace validations linked to the account. Only account IDs matching the pattern [a-zA-Z0-9_.-]+ are supported. Learn more at Create an Account ID.

check_manual_review_availability boolean

Evaluates the availability for manual review according to the review schedule. If unavailable, the manual review will be skipped without affecting the validation status, and the manual review status will be marked as unavailable.

phone_locale enum
Allowed: en | es | pt-BR

[Required for phone-verification] Language used to perform the validation via the selected verification channel.

subvalidations enum
Allowed: passive_liveness | similarity | speech_match

Indicates which subvalidations you want to perform during the face-recognition validation execution. If omitted, only similarity will be used. You can select more than one.

retry_of_id string

[Required if you have active retries] Refers to the validation_id of the failed validation. Remember that it is also necessary to send the same account ID (even if it is the automatically generated one) of the failed validation.
Note: When type is face-recognition, only available if passive liveness is enabled.

document_type enum
Allowed: national-id | foreign-id | driver-license | passport | identity-card | rut | ppt | invoice | picture-id | record | cnh

[Required for document-validation] Set this value to the type of document been validated. For ppt please ask sales team.

Refer to Supported Document Types for a complete reference of supported document types, applicable countries and document front/reverse picture requirements.

custom_type string

For document-validation, when specified, indicates the name of the Custom Type check to be used when a background check linked to this validation is desired. Keep in mind that the Custom Type check must already exist.

country string

[Required for document-validation] Set the country of the document being validated. Use ALL when document_type is set to passport.
For BR,CR, please ask sales team.

  • Allowed: CO | CL | MX | PE | BR | CR | ALL

[Required for face-search] Country of the face to be searched in reported lists (TruFace).
Use ALL when using TruFace (face-search) as a Face Validation compliment.

  • Allowed: ALL | BR | CL | CO | CR | EC | MX | PE

phone_type enum
Allowed: home | office | recover

[Required for phone-verification] Specifies the label of the phone number to be associated with the validation account upon successful validation. The phone type must have already been enrolled.

threshold number

Determines the required similarity between the provided picture and video or selfie to pass the face-recognition validation, ranging from 0 to 1. By default, the threshold is set to 0.65.

timeout integer

The time, in seconds, users will have to complete the validation. If omitted, the timeout from the client’s config will be used.

  • Default: 300 (5 minutes) for all validators.
  • Max: 600 (10 minutes) for phone-verification and email-verification;
    21600 (6 hours) for document-validation, face-recognition and face-search.

language enum
Allowed: es | en

For email-verification, specifies the language of the email that the final user receives.

minimum_precision enum
Allowed: very_high | high | medium | low

[Required for speech_match subvalidation] Minimum precision that the audio transcription obtained from the video selfie should have with the speech_token.

verify_channel enum
Allowed: sms | call | whatsapp

[Required for phone-verification] Indicates the channel used to perform the verification. Some problems may occur when receiving the SMS due to external protocols of the mobile service providers, so we recommend giving an additional option to the users.

If you set whatsapp as the verify_channel value, you must have your own WABA line and Activate it. Then, create your Outbound message of type OTP and Contact Support to provide your Outbound ID for inclusion in your process.

Perform sync validation

Performs a sync validation for the specified validation_id within the specified account_id. Examples of these validators include phone and email. Not applicable to async validators such as document or face.

If a previous validation attempt was unsuccessful, this will count as a retry, which could occur due to errors such as a typo in the token or other mistakes.
Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: email-verification | phone-verification

Indicates the type of validation to be performed.

token string
[Required]

The validation code sent to the user’s email or phone (via SMS, call, or WhatsApp) for verification.

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
account_id string
[Required]
The account ID associated with the validation.
validation_id string
[Required]
ID of the validation to be performed.

Create Validation

Creates a new validation for the specified validation type. This process allows your company to confirm that the user’s identity matches the provided information (such as documents, images, videos, or codes like OTP), ensuring accuracy and security in the verification process, which is crucial for legal responsibilities.
Request
Request Body *application/x-www-form-urlencoded
user_authorized boolean
[Required]

This indicates that you have the authorization of the person to be verified. This is mandatory in order to comply with data protection laws. Value must be set to true in order to perform the validation.

type enum
[Required]
Allowed: document-validation | face-recognition | email-verification | phone-verification | face-search

Indicates the type of validation to be performed.

account_id string
[Required]

Account ID linked to the validation.
For document-validation, an account ID is automatically created if omitted; otherwise, the custom account ID provided is used.
For other validations, use the same account ID from the enrollment process.
The account ID helps trace validations linked to the account. Only account IDs matching the pattern [a-zA-Z0-9_.-]+ are supported. Learn more at Create an Account ID.

minimum_precision enum
Allowed: very_high | high | medium | low

[Required for speech_match subvalidation] Minimum precision that the audio transcription obtained from the video selfie should have with the speech_token.

retry_of_id string

[Required if you have active retries] Refers to the validation_id of the failed validation. Remember that it is also necessary to send the same account ID (even if it is the automatically generated one) of the failed validation.
Note: When type is face-recognition, only available if passive liveness is enabled.

threshold number

Determines the required similarity between the provided picture and video or selfie to pass the face-recognition validation, ranging from 0 to 1. By default, the threshold is set to 0.65.

timeout integer

The time, in seconds, users will have to complete the validation. If omitted, the timeout from the client’s config will be used.

  • Default: 300 (5 minutes) for all validators.
  • Max: 600 (10 minutes) for phone-verification and email-verification;
    21600 (6 hours) for document-validation, face-recognition and face-search.

language enum
Allowed: es | en

For email-verification, specifies the language of the email that the final user receives.

phone_type enum
Allowed: home | office | recover

[Required for phone-verification] Specifies the label of the phone number to be associated with the validation account upon successful validation. The phone type must have already been enrolled.

country string

[Required for document-validation] Set the country of the document being validated. Use ALL when document_type is set to passport.
For BR,CR, please ask sales team.

  • Allowed: CO | CL | MX | PE | BR | CR | ALL

[Required for face-search] Country of the face to be searched in reported lists (TruFace).
Use ALL when using TruFace (face-search) as a Face Validation compliment.

  • Allowed: ALL | BR | CL | CO | CR | EC | MX | PE

verify_channel enum
Allowed: sms | call | whatsapp

[Required for phone-verification] Indicates the channel used to perform the verification. Some problems may occur when receiving the SMS due to external protocols of the mobile service providers, so we recommend giving an additional option to the users.

If you set whatsapp as the verify_channel value, you must have your own WABA line and Activate it. Then, create your Outbound message of type OTP and Contact Support to provide your Outbound ID for inclusion in your process.

custom_type string

For document-validation, when specified, indicates the name of the Custom Type check to be used when a background check linked to this validation is desired. Keep in mind that the Custom Type check must already exist.

document_type enum
Allowed: national-id | foreign-id | driver-license | passport | identity-card | rut | ppt | invoice | picture-id | record | cnh

[Required for document-validation] Set this value to the type of document been validated. For ppt please ask sales team.

Refer to Supported Document Types for a complete reference of supported document types, applicable countries and document front/reverse picture requirements.

phone_locale enum
Allowed: en | es | pt-BR

[Required for phone-verification] Language used to perform the validation via the selected verification channel.

subvalidations enum
Allowed: passive_liveness | similarity | speech_match

Indicates which subvalidations you want to perform during the face-recognition validation execution. If omitted, only similarity will be used. You can select more than one.

check_manual_review_availability boolean

Evaluates the availability for manual review according to the review schedule. If unavailable, the manual review will be skipped without affecting the validation status, and the manual review status will be marked as unavailable.

Perform validation

Perform validation for the specified validation_id. If a previous validation attempt was unsuccessful, this will count as a retry, which could occur due to errors such as a typo in the token or other mistakes.
Request
Request Body *application/x-www-form-urlencoded
type enum
[Required]
Allowed: email-verification | phone-verification

Indicates the type of validation to be performed.

token string
[Required]

The validation code sent to the user’s email or phone (via SMS, call, or WhatsApp) for verification.

Response
post /v1/validations/{validation_id}

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
validation_id string
[Required]
ID of the validation to be performed.

File Upload

Allows the upload of binary files, such as images or videos, needed for document validation or person verification. To upload a file, make a PUT request to the URL provided during the validation or enrollment process.
Request
Request Body *
file binary
[Required]

Accepts binary files such as images, videos, or other types of files, encoded in Base64 format. This input is used for uploading media or documents required in identity verification processes.

Response
put {file_upload_url}

Get account validations

Retrieve all validations associated with a specific account id. This is useful to easily have all validations of a user in one place.

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
account_id string
[Required]
The account ID linked with the validations.

Get Validation from Account

Retrieves the detailed information of a specific validation using an account_id and validation_id. This object is useful for understanding the exact status of the validation process. You can retrieve the current status and results of a validation, where the validation_status begins as pending and can either be success or failure upon completion.

To obtain details such as the inputs or uploaded media for the validation, you can include the query parameter show_details with the value of true.

To learn more about the reasons for failure, please refer to the following guides:

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure

Get all user Validations

This endpoint allows you to list all validations associated with your users, enabling effective tracking of their current statuses. The returned object provides insights into the exact status of each validation process, where the validation_status begins as pending and can ultimately result in either success or failure.

To learn more about the reasons for failure, please refer to the following guides:

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure

Get Validation

Returns a validation object given a validation_id. This object is useful for understanding the exact status of the validation process. You can retrieve the current status and results of a validation, where the validation_status begins as pending and can either be success or failure upon completion.

To obtain details such as the inputs or uploaded media for the validation, you can include the query parameter show_details with the value of true.

To learn more about the reasons for failure, please refer to the following guides:

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure
Path Parameters
validation_id string
[Required]
Unique identifier of the validation.
Query Parameters
show_details boolean
[Optional]
If set to true, allows you to visualize the file uploaded by the user.

Config

The Config Validators feature allows for customization of various parameters to improve the behavior of the validators. This is particularly valuable when you wish to set different decision parameters like thresholds, timeouts, manual review enabling, and more. Below are the parameters that are configurable across multiple validators.

  • timeout: The amount of time, in seconds, that users will have to perform the validation before it times out.

  • allowed_retries: The number of times the validation may be retried before failing.

  • retry_ttl: The time to live (TTL), in seconds, for creating a retry of any validation.

    ParametersDocument ValidatorFace ValidatorPhone ValidatorEmail Validator
    timeoutXXXX
    allowed_retriesXXXX
    retries_ttlXX--

Config by Validator Type

Each Validator has its own particularities and specific parameters (not listed in the table above) that you may modify to better suit your company’s needs. To learn about specific configurable parameters, default values, and special considerations, please visit the guide for the validator you want to configure:

NOTES:

  • The Config Validators parameters are global to your account and will affect all validations performed across it.

  • However, validations performed in a Flow will prioritize the configuration in the Validator Block of your flow. All other parameters, not configurable within the Flow Builder, will take the global configuration values. To learn about flows, please visit the Create your first flow guide from our Digital Identity documentation.

Update config

Allows updating the values of various parameters to improve the behavior of the validators, such as timeout, allowed retries, threshold, manual review, among other properties from our validators. For more datails about customizable parameters for each validator, please refer to the individual configuration guides:

Request
Request Body *application/x-www-form-urlencoded
validator enum
[Required]
Allowed: face-recognition | email-verification | phone-verification | document-validation

Validator to be configured.

timeout number

The time, in seconds, users will have to complete the validation.

  • Default: 300 (5 minutes) for all validators.
  • Max: 600 (10 minutes) for phone-verification and email-verification;
    21600 (6 hours) for document-validation and face-recognition.

include_face_search boolean

When set to true, adds face_search subvalidation to the face-recognition validation. This enables the system to check if the uploaded face is reported in Truface (face-search).

validation_method.image-analysis.status enum
Allowed: enabled | disabled

Checks for any alterations or edits in the image of the validated document in document-validation.

allowed_retries number

The number of times the validation may be retried before failing.

Note: For face-recognition, retry feature is only available when passive liveness is enabled in the Face Validation process. For more information visit the Facial Recognition Methods guide.

  • For document-validation: The default value is 0 retries, with a maximum of 3 retries.

  • For face-recognition: The default value is 0 retries, with a maximum of 2 retries.

  • For email-verification and phone-verification: The default value is 2 retries, with a maximum of 4 retries.

validation_method.photo-of-photo.status enum
Allowed: enabled | disabled

Analyzes if the image used for validation is a photograph of a photograph of a document in document-validation.

retry_ttl number

Available for document-validation and face-recognition.

The time to live (TTL), in seconds, for creating a retry of any validation.

  • For document-validation: The default value is 300 seconds (5 minutes), with a maximum of 1800 seconds (30 minutes) and a minimum of 1 second.

  • For face-recognition: The default and maximum value is 300 seconds (5 minutes), with a minimum of 1 second.

    Note: For face-recognition, retry feature is only available when passive liveness is enabled in the Face Validation process. For more information visit the Facial Recognition Methods guide.

threshold number

Determines the required similarity, ranging from 0 to 1, between the provided picture and the video or selfie used to pass the face-recognition validation. By default, the threshold is set to 0.65.

custom_name string

Custom text within the OTP phone-verification messages, up to 30 characters. For details, language options and default values, see the Phone Validator Config guide.

email_text_1 string

Custom text appearing before the verification code in the email-verification validator email. For details, language options and default values, see the Email Validator Config guide.

use_manual_review boolean

Determines whether manual review will be performed upon face-recognition validation failure. You must contact Truora to activate this service. For more information about manual review, please visit the Manual Review guide.

email_subject string

Custom subject text in the email-verification validator email. For details, language options and default values, see the Email Validator Config guide.

document_version enum
Allowed: mx_ine-c | mx_ine-d | mx_ine-e | mx_ife-f | mx_ife-g | mx_fm3 | co_national-id-2000 | co_national-id-2020 | co_foreign-id | co_ppt | passport

The version of the document_type for which the document-validation configuration will be updated. If omitted, all supported document versions will be affected.

Note: For a complete list of Allowed document versions available by country and document type, refer to the tables in Appendix 1: Supported Document Versions. Please contact our Support Team for further assistance.

email_text_2 string

Custom text appearing after the verification code in the email-verification validator email. For details, language options and default values, see the Email Validator Config guide.

country enum
Allowed: CO | CL | MX | PE | BR | ALL

Country for which the document-validation configuration will be updated.

email_title string

Custom main title text in the email-verification validator email. For details, language options and default values, see the Email Validator Config guide.

support_email string

Custom support email address displayed at the bottom of the email-verification validator email. For details, language options and default values, see the Email Validator Config guide.

validation_method.data-consistency.status enum
Allowed: enabled | disabled

Analyzes the extracted data from the document for consistency in document-validation, such as date of birth and document number.

validation_method.government-database-validation.status enum
Allowed: enabled | disabled

Validates the extracted identification number against government databases in document-validation.

validation_method.photocopy-analysis.status enum
Allowed: enabled | disabled

Analyzes if the image used for document-validation is a photocopy of a document.

validation_method.manual-review.status enum
Allowed: enabled | disabled

Determines whether manual review will be performed upon validation failure in document-validation.

For more information about manual review, please visit the Manual Review guide.

document_type enum
Allowed: national-id | foreign-id | driver-license | passport | identity-card | rut | ppt | invoice | picture-id | record | cnh

[Required if modifying a validation_method] The type of document for which the document-validation configuration will be updated. If omitted, all supported document types will be affected.

Note: Refer to Appendix 1 tables in the Document Validator Config guide for a list of supported Document Types by Country.

object

ConfigMap

Field Type Description
document-validation object
country string Country for which the document validation configuration will be created
Options: ALL| CO| CL| MX| BR| PE
document_type string Document type for which the document validation configuration will be created
Options: passport| driver-license| general-registration| foreign-id| national-id| pep
document_version string Document version of the document type
Options: mx_ine-f| mx_ine-e| mx_ine-g| mx_ife-c| mx_ife-d| mx_fm3| co_national-id-2000| co_national-id-2020| co_foreign-id| co_pep| br_any| passport
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
validation_methods string Comma-separated list of validation methods. Allowed methods are: ``data-consistency``, ``government-database``, and ``image-analysis``.
email-verification object
allowed_retries number Number of times users will be allowed to retry the validation
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
enterprise-data object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
face-recognition object
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
identity-questions object
allowed_retries number Number of times users will be allowed to retry the validation
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
phone-verification object
allowed_retries number Number of times users will be allowed to retry the validation
custom_name string Custom name for verification messages
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
voice-recognition object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default

Get Config

Fetches the current configuration state for all validators associated with your account.

Note: Since the response includes configuration details for all validators linked to your account, please review the specific validator details youโ€™re interested in carefully.

Response
get /v1/config

object

ConfigMap

Field Type Description
document-validation object
country string Country for which the document validation configuration will be created
Options: ALL| CO| CL| MX| BR| PE
document_type string Document type for which the document validation configuration will be created
Options: passport| driver-license| general-registration| foreign-id| national-id| pep
document_version string Document version of the document type
Options: mx_ine-f| mx_ine-e| mx_ine-g| mx_ife-c| mx_ife-d| mx_fm3| co_national-id-2000| co_national-id-2020| co_foreign-id| co_pep| br_any| passport
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
validation_methods string Comma-separated list of validation methods. Allowed methods are: ``data-consistency``, ``government-database``, and ``image-analysis``.
email-verification object
allowed_retries number Number of times users will be allowed to retry the validation
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
enterprise-data object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
face-recognition object
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
identity-questions object
allowed_retries number Number of times users will be allowed to retry the validation
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
phone-verification object
allowed_retries number Number of times users will be allowed to retry the validation
custom_name string Custom name for verification messages
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
voice-recognition object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default

Delete Config

Allows you to delete a validatorโ€™s configuration or a specific parameter (type) within the validatorโ€™s configuration. Deleting the configuration resets its values back to their defaults.

Note: If you omit the type parameter when sending the request, all configurations associated with the validator will be deleted, reverting all values to their default settings.

object

ConfigMap

Field Type Description
document-validation object
country string Country for which the document validation configuration will be created
Options: ALL| CO| CL| MX| BR| PE
document_type string Document type for which the document validation configuration will be created
Options: passport| driver-license| general-registration| foreign-id| national-id| pep
document_version string Document version of the document type
Options: mx_ine-f| mx_ine-e| mx_ine-g| mx_ife-c| mx_ife-d| mx_fm3| co_national-id-2000| co_national-id-2020| co_foreign-id| co_pep| br_any| passport
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
validation_methods string Comma-separated list of validation methods. Allowed methods are: ``data-consistency``, ``government-database``, and ``image-analysis``.
email-verification object
allowed_retries number Number of times users will be allowed to retry the validation
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
enterprise-data object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
face-recognition object
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
identity-questions object
allowed_retries number Number of times users will be allowed to retry the validation
threshold number Correctness required to pass the validation from 0 to 1
Format: float
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
phone-verification object
allowed_retries number Number of times users will be allowed to retry the validation
custom_name string Custom name for verification messages
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
voice-recognition object
timeout number Time in seconds users will have to perform the validation. 5 minutes by default
Query Parameters
type enum
[Optional]
If validator is document-validation:
Allowed: timeout | allowed_retries | use_manual_review | document_config | retry_ttl

If validator is face-recognition:
Allowed: threshold | timeout | enrollment_timeout | use_manual_review | include_face_search

If validator is email-verification:
Allowed: timeout | allowed_retries | email_subject | email_title | email_text_1 | email_text_2 | support_email

If validator is phone-verification:
Allowed: allowed_retries | timeout | custom_name

Configuration type to be reset. If provided, the validator reset will only affect the selected configuration; otherwise, all configurations will be reset.

Note : For document-validation, setting the type field to document_config will reset any Document Version Config to their default values.
validator enum
[Required]
Allowed: document-validation | face-recognition | email-verification | phone-verification

Name of the validator’s config to be deleted.

Status

Status lets you check the current state of our services in real time.

Get status

Checks the current availability of the validations API. If this endpoint fails, it means the validations api is down and should contact support.
Response
get /v1/status

object

Validation

Field Type Description
account_id string Validation account ID
creation_date string Validation creation date. RFC3339 format. Example: 2020-01-16T19:20:31.024522827Z
Format: date-time
declined_reason string Describes the reason why the validation was rejected. Only visible if ``failure_status`` is ``declined``.
Options: image_analysis_not_passed| document_not_recognized| data_inconsistency| government_database_check_failed| ocr_no_text_detected| empty_input_file| invalid_curp| missing_text| invalid_mrz| age_above_limit| underage| invalid_issue_date| national_registrar_inconsistency| production_data_inconsistency| identity_belongs_to_dead_person| face_not_found_in_document| max_retries_reached
details object
document_details object
document_id string Document ID
document_validations object
data_consistency array Validation applied to documents regarding data consistency
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
government_database array Validation applied to documents regarding government databases
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
image_analysis array Validations applied to the document regarding image analysis
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
manual_review array Allows performing manual reviews on documents when their validation failed.
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
photocopy-analysis array Validations applied to the document aimed to detect the use of a photocopy instead of the original document
message string Message describing the result of the validation
result string Validation result
Options: valid| invalid
validation_name string Type of validation performed on the document
validation_type string Validation type identifier
expired_reason string Describes the reason why the validation was expired. Only visible if ``failure_status`` is ``expired``.
Options: validation_not_performed| input_file_not_uploaded| pending_validation_methods| manual_review_expired
failure_status string Defines the reason why the validation failed. ``system_error`` means an error occurred while processing the validation, ``expired`` means the validation took too long to have a result, usually because the user took too long to submit the required information, and ``declined`` means the process was completed successfully but the subject did not pass the validation. A more detailed message is shown in the field ``declined_reason`` when the failure status is ``declined``
Options: declined| expired| system_error
flow_id string ID of the identity flow
front_image string URL of the ID document front picture submitted by the user
identity_process_id string ID of the Identity Process
ip_address string Validation IP address
reverse_image string URL of the ID document back picture submitted by the user
type string Validation type
Options: identity-questions| face-recognition| voice-recognition| email-verification| phone-verification| document-validation
validation_id string Validation ID
validation_status string Indicates whether the validation was successful. If failure, additional information can be found in the ``failure_status`` field, ``pending`` means the validation is still ongoing
Options: pending| success| failure