Document Check Agent

Version: 1.9.10-public.beta.4

The Document Check Agent is a multi-agent system designed to guarantee the authenticity of identity documents, ensuring they are valid, have not been tampered with, and meet security standards. This agent can be used when you need to validate the authenticity of a document and extract information accurately.

This agent has the capability to extract information from 1,400 document types from 255 different countries.

User experience

We ask the user to provide photographs of the identity document from both sides and perform some validations.

✅ Checklist to start without blockers

The user must be able to send or capture photos from the chat (camera permissions must be enabled on the device if applicable).
Define the country (or “All”) and the type of validation you need before configuring.
Recommended: define the handling flow if you enable Human in the loop (who reviews, response times, and what happens if there is no response).

Document Detection and Classification

We automatically identify the type of document presented, such as national ID, passport, or driver’s license.

Element Extraction and Verification (OCR)

Using OCR technology, we extract and validate text, holder photo, and other key elements, ensuring the correct reading of data such as name, document number, and nationality.

Authenticity and Integrity Verification

We check that the document has not been altered, verifying security elements such as holograms, number format, and holder photo authenticity. We also cross-reference information from the MRZ zone, visible OCR, and barcode to ensure the coherence and consistency of all data.

Physical Tampering Detection

We detect any physical manipulation in the document, such as photo substitution or modification of printed data, ensuring the document is genuine.

Government entity query by country

A query is made to the government entity databases of each country:

🇪🇨 Ecuador: Civil Registry query
🇨🇱 Chile: Civil Registry query
🇨🇴 Colombia: ANI query (National Registry database)
🇲🇽 México: INE and Renapo query
🇵🇪 Perú: Reniec query

Configuration

Inputs
Outputs

Country

string

Variable: countryAgent. Country of the document to be validated.Available values: Ecuador, Colombia, Chile, Perú, México, All

Validate document quality

string

default:"medium"

Variable: validateQACheck. Validation level for document quality.Available values: low, medium, high

Disable image request

boolean

default:"false"

Variable: disableImagesDocument. Enable the document image request.

This parameter only applies to Ecuador.

Available values: false, true

Max. Document check attempts

number

default:"3"

Variable: maxBiometricAttempts. Maximum number of attempts.Available values: 1-6

Notification email for exceeded retries

string

Variable: customerServiceEmail. Email to be notified when the maximum number of attempts is exceeded.

Verify document expiration date

string

default:"Disabled"

Variable: dateExpiracyCheck. Verifies the expiration date of the document.Available values: Disabled, Enabled

Enable government validation

boolean

default:"true"

Variable: flagGovValidation. Enables government validation; when false, the respective civil registry is not queried.Available values: false, true

Verify legal age

boolean

Variable: validateAgeCheck. Allows validating whether the user meets the legal age requirement.Available values: false, true

Enable Human in the loop

boolean

default:"false"

Variable: enableHumanInLoop. Indicates whether the review process with a human agent is activated.Available values: false, true

Max. agent attempts

string

default:"Unlimited"

Variable: retriesAgent. Maximum number of agent attempts before blocking the user.Available values: Unlimited, 1, 2, 3

User block duration

string

default:"1 day"

Variable: blockingInHours. Block duration after exceeding attempts.Available values: 1 day, 1 week, 1 month

✅ Success

Document Validation successful

The Document validation was successful.Variable: documentCheckSuccess

To access the information in this variable use the command $memory.get("response_document_check_success")

Response example:

{
  "response_document_check_success": {
    "document_check": {
      "verified_fields": {
        "...": "Main document data"
      },
      "secondary_fields": {
        "...": "Secondary document data"
      },
      "details": {
        "...": "Document type details"
      },
      "image_quality_details": {
        "...": "Image quality details"
      },
      "images_extracted": {
        "...": "Images extracted from the document"
      },
      "gov_entity_fields": {
        "...": "Data used to validate against the government entity"
      }
    },
    "gov_entity_data": {
      "...": "Data obtained from the country's government entity (variables vary by country)"
    },
    "document_image_front_url": "URL of the front image of the document",
    "document_image_back_url": "URL of the back image of the document",
    "document_face_image_url": "URL of the face photo from the document"
  }
}

Examples by country:

🇨🇴 Colombia

{
  "gov_entity_data": {
    "primer_nombre": "",
    "segundo_nombre": "",
    "primer_apellido": "",
    "segundo_apellido": "",
    "nombres": "",
    "apellidos": "",
    "fecha_expedicion": "",
    "estado_documento": "0",
    "usuario_fallecido": false
  }
}

🇪🇨 Ecuador

{
  "gov_entity_data": {
    "nUI": "09xxxxxxxx",
    "sexo": "",
    "calle": "",
    "error": "",
    "firma": "",
    "nombre": "",
    "conyuge": "",
    "nombres": "",
    "apellidos": "",
    "domicilio": "",
    "profesion": "",
    "fotografia": "https://....",
    "numeroCasa": "5",
    "codigoError": "",
    "estadoCivil": "",
    "instruccion": "",
    "nombreMadre": "",
    "nombrePadre": "",
    "nacionalidad": "",
    "fechaCedulacion": "dd/mm/yyyy",
    "fechaNacimiento": "dd/mm/yyyy",
    "lugarNacimiento": "",
    "condicionCedulado": "",
    "fechaFallecimiento": "",
    "provincia": "",
    "ciudad": "",
    "parroquia": "",
    "primerNombre": "",
    "segundoNombre": "",
    "primerApellido": "",
    "segundoApellido": ""
  }
}

Important fields:

document_check: Complete information of the validated document
gov_entity_data: Data obtained from the government entity (varies by country)
document_image_front_url: URL of the front image
document_image_back_url: URL of the back image
document_face_image_url: URL of the face photo extracted from the document

Information saved in Memory:The agent automatically saves the following information in memory variables:

{
  "isValid_document_check": true,
  "isValid_government_entity": true,
  "response_document_check_success": {
    "document_check": {
      "secondary_fields": {
        "mrz_strings": "Complete MRZ lines extracted from the document.",
        "second_surname": "Second surname of the holder.",
        "nationality_code": "Nationality code in ISO format.",
        "personal_number_checkdigit": "Check digit of the personal number.",
        "date_of_registration": "Date the document was registered.",
        "date_of_birth": "Date of birth in MRZ format.",
        "sex": "Sex of the holder (M/F).",
        "date_of_birth_checkdigit": "Check digit of the date of birth.",
        "date_of_expiry": "Document expiration date in MRZ format.",
        "final_checkdigit": "Overall MRZ check digit.",
        "issuing_state_code": "Country code of the document issuer.",
        "document_class_code": "Document type code (e.g. passport, ID).",
        "optional_data": "Optional data defined by the country.",
        "line2_optional_data": "Additional optional data in MRZ line 2.",
        "mrz_type": "MRZ format (e.g. ID-1, ID-2).",
        "given_names": "First names of the holder.",
        "date_of_expiry_checkdigit": "Check digit of the expiration date.",
        "personal_number": "Personal number assigned to the holder.",
        "surname": "Primary surname of the holder.",
        "surname_&_given_names": "Surnames and names concatenated.",
        "date_of_issue": "Date the document was issued."
      },
      "details": {
        "issuing_country": "Country that issued the document.",
        "document_name": "Name of the recognized document model.",
        "document_title": "Document title or type.",
        "document_description": "Brief description of the document.",
        "document_country_name": "Name of the issuing country in text."
      },
      "status_fields": {
        "optical": "Overall optical validation status.",
        "details_optical": {
          "expiry": "Expiration date validation result.",
          "security": "Security validation status.",
          "overall_status": "Overall result of optical checks.",
          "text": "OCR text reading status.",
          "image_QA": "Image quality result.",
          "doc_type": "Document type validation result.",
          "mrz": "MRZ validation result."
        },
        "overall_status": "Overall field check status."
      },
      "security_fields": {
        "barcode_format_check": {
          "status": "Numeric result of the barcode check.",
          "validations": [
            {
              "element_result": "Barcode validation result.",
              "element_diagnose": "Validation diagnosis.",
              "element_type": "Type of element validated."
            }
          ],
          "status_text": "Text of the barcode validation result."
        }
      },
      "images_extracted": {
        "portrait": {
          "image": "Portrait image extracted from the document.",
          "format": "Format of the extracted image."
        },
        "ghost_portrait": {
          "image": "Ghost portrait image in the document.",
          "format": "Format of the extracted ghost portrait."
        }
      },
      "image_quality_details": {
        "glares": {
          "status": "Numeric result of glare check.",
          "status_text": "Glare check status."
        },
        "portrait": {
          "status": "Numeric result of portrait detection.",
          "status_text": "Portrait detected in document status."
        },
        "focus": {
          "status": "Numeric result of image focus.",
          "status_text": "Image focus status."
        },
        "bounds": {
          "status": "Numeric result of document framing.",
          "status_text": "Document framing status."
        },
        "perspective_angle": {
          "status": "Numeric result of perspective angle.",
          "status_text": "Perspective angle status."
        },
        "overall_result": "Overall image quality result.",
        "resolution": {
          "status": "Numeric result of image resolution.",
          "status_text": "Image resolution status."
        }
      },
      "verified_fields": {
        "mrz_strings": "Verified MRZ lines extracted from the document.",
        "second_surname": "Validated second surname.",
        "nationality_code": "Verified nationality code.",
        "remainder_term": "Remaining validity time in months.",
        "other": "Additional OCR text extracted from the document.",
        "personal_number_checkdigit": "Check digit of the personal number.",
        "date_of_registration": "Date the document was registered.",
        "date_of_expiry": "Verified document expiration date.",
        "sex": "Validated holder sex.",
        "date_of_birth_checkdigit": "Check digit of the date of birth.",
        "date_of_birth": "Validated date of birth.",
        "years_since_issue": "Years elapsed since issuance.",
        "final_checkdigit": "Global MRZ check digit.",
        "issuing_state_code": "Issuing country code.",
        "nationality": "Holder nationality.",
        "document_class_code": "Document type code.",
        "age_at_issue": "Holder age at document issuance.",
        "surname_and_given_names": "Concatenated verified surnames and names.",
        "mrz_type": "Validated MRZ format.",
        "given_names": "Validated holder first names.",
        "issuing_state_name": "Name of the issuing country.",
        "date_of_expiry_checkdigit": "Expiration check digit.",
        "personal_number": "Holder personal number.",
        "age": "Current holder age.",
        "surname": "Validated primary surname.",
        "date_of_issue": "Document issue date."
      }
    },
    "gov_entity_data": {
      "apellidos": "Full last names of the person according to the civil registry.",
      "codigoError": "Error code returned by the query system.",
      "condicionCedulado": "Citizen condition in relation to their ID.",
      "conyuge": "Spouse name if registered.",
      "error": "Informational message about the query result.",
      "estadoCivil": "Current civil status of the person.",
      "fechaCedulacion": "Date the identity card was issued.",
      "fechaNacimiento": "Date of birth of the citizen.",
      "instruccion": "Registered education or instruction level.",
      "lugarNacimiento": "Province, city and parish of birth.",
      "nUI": "Unique Identification Number of the citizen.",
      "nacionalidad": "Officially registered nationality.",
      "nombre": "Full name of the citizen with surnames and names.",
      "nombreMadre": "Full names and surnames of the mother.",
      "nombrePadre": "Full names and surnames of the father.",
      "nombres": "First names of the person.",
      "profesion": "Profession or occupation registered in the system.",
      "sexo": "Sex of the person according to the civil registry.",
      "calle": "Name of the street registered as address.",
      "domicilio": "Full address registered in the system.",
      "numeroCasa": "House or domicile number registered.",
      "fechaFallecimiento": "Date of death, if applicable.",
      "firma": "Digital image of the citizen's signature.",
      "fotografia": "Digital image of the citizen's face.",
      "provincia": "Province registered at domicile.",
      "ciudad": "City registered at domicile.",
      "parroquia": "Parish registered at domicile.",
      "primerNombre": "First name registered for the person.",
      "segundoNombre": "Second name registered for the person.",
      "primerApellido": "First surname registered for the person.",
      "segundoApellido": "Second surname registered for the person."
    },
    "document_image_front_url": "URL of the front image of the document",
    "document_image_back_url": "URL of the back image of the document",
    "document_face_image_url": "URL of the face photo from the document"
  }
}

Available variables:

$memory.isValid_document_check: Indicates whether document validation was successful (true) or not (false)
$memory.isValid_government_entity: Indicates whether validation with the government entity was successful (true) or not (false)
$memory.response_document_check_success: Complete response of the validation process with all detailed parameters

The gov_entity_data object within response_document_check_success depends on the response from the queried country’s government entity. Available fields vary by country (Colombia, Ecuador, Chile, México, Perú). The example shown corresponds to Ecuador.

Structure for Perú (RENIEC):Depending on the connection used with our providers, the RENIEC response may contain two sets of data: those that are always present and those that only return in certain cases.Fields always present:

{
  "documentNumber": "Unique identification number assigned to the DNI.",
  "documentType": "Type of document issued.",
  "fullName": "Full name registered in RENIEC",
  "firstName": "First name registered in RENIEC",
  "lastName": "Full last names registered in RENIEC",
  "maternalLastName": "Maternal last name registered in RENIEC",
  "paternalLastName": "Paternal last name registered in RENIEC",
  "dateOfBirth": "Date of birth of the citizen in ISO format.",
  "sex": "Sex of the person registered in RENIEC."
}

Additional fields (not always present):

{
  "address": "Registered domicile address of the citizen according to RENIEC.",
  "civilStatus": "Civil status of the citizen.",
  "expeditionDate": "Date the document was issued.",
  "expirationDate": "Identity document expiration date.",
  "photo": "Official photo of the citizen.",
  "ubigeoReniec": "Official geographic location code from RENIEC.",
  "verificationDigit": "Verification digit that validates the DNI number."
}

You can access this information at any point in the flow using $memory.get("isValid_document_check"), $memory.get("isValid_government_entity"), or $memory.get("response_document_check_success").

🔴 Errors

Service Error

An error occurred in the document validation process.Variable: serviceError

Time Expired

The time to complete the process has expired.Variable: timeExpiredError

Process Abandoned

The user abandoned the process.Variable: userExitProcess

Document Validation NOT successful

The user’s document could not be validated.Variable: documentCheckError

User Blocked

User Blocked.Variable: userBlocked

Integration

Select the workflow

Go to the Workflow within the company where you need to install this Agent. Click the floating button with the workflow name and the folder icon to open the Workflows & Tools panel. Select “Open Marketplace” and there type the Agent name and download it.

Initial configuration

The first thing to configure is the Version found under “Advanced settings”.None of the inputs are mandatory fields because they have default values assigned. If you need to change them, you can enter the value in the corresponding field.You can also edit the texts if the client needs to “customize” the tone of the conversation.

Configure Outputs

This Agent has 4 error outputs and 1 success output. Each can be directed to:

A text box with a custom message
The PMA (Multiagent Panel) if the client has this module

Run tests

With the configuration you just completed, you can proceed to run tests using a workflow or another agent as a precursor.

Frequently asked questions

Is this agent considered a biometric process?

No, the “Document Check” process is only a “stage” of the biometric process, therefore it is not considered facial biometrics.

What documents are required during the interaction of this process?

Only the photo of the identity document is required.

Can I disable government validation and only extract information from the document?

Yes, you can disable government validation in the input Enable government validation (false). This option is enabled by default.

Getting Started

AI Agents

Brain

Nodes

Databases

Variables

Tools

Functions

Channels

Configuration

Marketplace

Billing

User experience

✅ Checklist to start without blockers

Document Detection and Classification

Element Extraction and Verification (OCR)

Authenticity and Integrity Verification

Physical Tampering Detection

Government entity query by country

Configuration

✅ Success

🔴 Errors

Integration

Frequently asked questions

Getting Started

AI Agents

Brain

Nodes

Databases

Variables

Tools

Functions

Channels

Configuration

Marketplace

Billing

Documentation Index

​User experience

​✅ Checklist to start without blockers

Document Detection and Classification

Element Extraction and Verification (OCR)

Authenticity and Integrity Verification

Physical Tampering Detection

​Government entity query by country

​Configuration

​✅ Success

​🔴 Errors

​Integration

​Frequently asked questions

User experience

✅ Checklist to start without blockers

Government entity query by country

Configuration

✅ Success

🔴 Errors

Integration

Frequently asked questions