How-to

Guide to Get Results

In simple terms: After someone completes a verification, you need to see the results. This guide shows you how to view and download verification results from the Dashboard or get them automatically through your system.

This guide explains how to search and retrieve results from Identity Processes and Validations using Truora’s dashboard or API.

Get the results of a process

From Truora’s Dashboard

Searching process results

  1. In the Digital Identity dashboard, go to the Results tab in the side menu.
  2. At the top, ensure the PROCESSES RESULTS tile is selected.
Process results view
  1. Use the Search bar to look up results:

Search by one of these parameters:

  • For Process ID and Flow ID, an exact match is required.
  • For Account ID, Document Number, Phone number and Name, partial matches are supported.

Additionally you can apply a Filter to refine your search by:

  • State - Filter by process Status: Success, Pending or Failure. If Failure is selected, you may further filter by the Declined Reason.
  • Date Range - Select a date range for search.
Process results search
  1. Use the Show dropdown menu to customize visible columns in the results list. By default, ALL columns are displayed:
  • Process ID, Flow ID, Account ID - Unique identifiers for the process, flow and the user account.
  • Document number, Name, Phone number - User details associated to the process.
  • State - The process outcome: Success, Pending or Failure.
  • Failed Step - The step where the process failed (if applicable).
  • Channel - The channel used to perform the process (Web or Whatsapp).
  • Creation date - Timestamp of when the process started.
  • Step Progress - Number of completed steps vs. total steps in the process.
Process show custom columns

Viewing details of a specific process

To view details about a specific process, just click on it in the list. The details displayed will depend on the process content:

Process results details

  • General process details

    • Process ID - The unique ID of the process carried out by the user.
    • Account ID - The account ID of the user who initiated the process.
    • Flow ID - The ID of the flow related to the user’s process.
    • Creation date - Timestamp of when the process started.

  • Failure, Declination, or Expiration details

    • Failure status - Information on why the process failed.
    • Declined reason - The reason why the process was cancelled.
    • Expiration reason - The reason why the process expired.

  • Validations details

    • You may find information about validations, and at the bottom of the view, you may expand the details on each validation performed within the process and its outcome.

  • Download PDF and Override Status

    • At the top of the details, you may click the Download PDF button to download a report of the process results. For details, see the Download Process PDF guide.

    • If you have the necessary permissions, you may see a Modify Status button. This allows you to override the final status of a completed process. For details, see the Override process status guide.

Downloading Process History (CSV)

You can download a CSV file containing a summary of process results within a specific date range (up to two months). If needed, you can include a Flow ID to filter results by a specific flow.

To find a Flow ID, you have at least two options:

  1. Copy the Flow ID with the copy icon when Viewing details of a specific process.
  2. Go to My flows and copy the desired Flow ID from the copy icon:
Copy web Flow ID

Once you have the Flow ID, follow these steps:

  1. Go to Results and click on the Download button.
  2. Select the language: Choose from English, Spanish, or Portuguese.
  3. Advanced Options (optional): You can request additional information by enabling advanced options. These may include:
  • Custom integration variables: Include data obtained from external services integrated in your flows.
  • Background check ID: Include the unique ID associated with background check processes.
  • Geolocation data: Include geographical location information collected during user interactions.
  • Agent Conversations: Include complete conversation history and support interactions.
  • Referral tracking information from Whatsapp: This information indicates the origin of users who send inbounds, useful for tracking campaign effectiveness.
  1. You may filter results by:
  • Range of dates only (Required) - Download history for all processes within a specific date range, up to two months.
  • Range of dates and a Flow ID (Optional) - Download history for processes related to the specific flow within the selected date range.
  1. Click Download.
Download process history csv

By means of Truora’s API

To get process results via Truora’s API follow these steps:

  1. Create a GET request to https://api.identity.truora.com/v1/processes/{process_id}/result
  2. Replace {process_id} in the URL with the Process ID obtained from Truora’s Dashboard, or by setting up a rule to receive process updates via Webhooks. *

* Note: For testing purposes, when Testing a flow template you can extract the Process ID from the process URL in this format: https://identity.truora.com/{process_id} (e.g., https://identity.truora.com/IDP58eec9282cxxxxxxxxx).

test process_id
  1. Create a Header named Truora-API-Key and set its value to your API key.
  2. Send the request. The response will include the process results.
GET
https://api.identity.truora.com/v1/processes/{process_id}/result 
                {
    "process_id": "IDP96aXXXXXXXX",
    "account_id": "ACCd64XXXXXXXX",
    "client_id": "TCI8abdXXXXXXXX",
    "flow_id": "IPF8daXXXXXXXX",
    "document_number": "123456789",
    "first_name": "JANE",
    "last_name": "DOE SMITH",
    "created_via": "web",
    "flow_version": 1,
    "country": "ALL",
    "status": "success",
    "validations": [
        {
            "validation_id": "VLD073XXXXXXXX",
            "ip_address": "186.XXX.XXX.XXX",
            "account_id": "ACCd64XXXXXXXX",
            "type": "document-validation",
            "validation_status": "success",
            "creation_date": "2025-03-20T12:03:05.663794685Z",
            "details": {
                "background_check": {
                    "check_id": "CHK59dXXXXXXXX",
                    "check_url": "https://api.checks.truora.com/v1/checks/CHK59dXXXXXXXX"
                },
                "document_details": {
                    "client_id": "TCI8abdXXXXXXXX",
                    "country": "CO",
                    "doc_id": "DCR6cXXXXXXX",
                    "document_type": "national-id",
                    "birth_place": "BOGOTA D.C. (CUNDINAMARCA)",
                    "creation_date": "2025-03-20T12:03:05.554122996Z",
                    "date_of_birth": "1981-02-17T00:00:00Z",
                    "document_number": "123456789",
                    "expedition_place": "BOGOTA D.C.",
                    "gender": "female",
                    "height": "1.61",
                    "issue_date": "1999-02-20T00:00:00Z",
                    "last_name": "DOE SMITH",
                    "mime_type": "image/jpeg",
                    "name": "JANE",
                    "national_registrar": "CARLOS DEMO",
                    "production_data": "P-15XXXXX-001XXXXX-F-1234XXXXX-200XXXXX",
                    "rh": "O+",
                    "update_date": "2025-03-20T12:03:39.864678126Z"
                },
                "document_validations": {
                    "data_consistency": [
                        {
                            "validation_name": "Validation of national registrar consistency",
                            "result": "valid",
                            "validation_type": "data-validation-national-registrar",
                            "message": "The national registrar is consistent",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:40.277861154Z"
                        },
                        {
                            "validation_name": "Validation of document number consistency",
                            "result": "valid",
                            "validation_type": "data-validation-document-number",
                            "message": "The document number is consistent",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:40.27785788Z"
                        },
                        {
                            "validation_name": "Validation of date of birth",
                            "result": "valid",
                            "validation_type": "date-of-birth-validation",
                            "message": "The date of birth is valid",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:40.277847828Z"
                        }
                    ],
                    "government_database": [
                        {
                            "validation_name": "Validation of Government Database - Registraduría",
                            "result": "valid",
                            "validation_type": "government-database-digital-validation-certificate-cedula",
                            "message": "Document is current and registered in main identity database",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:44.006731978Z"
                        }
                    ],
                    "image_analysis": [
                        {
                            "validation_name": "Validation of document text alterations",
                            "result": "valid",
                            "validation_type": "fake-text-validation",
                            "message": "Text alterations were not found in picture",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:47.704747036Z"
                        },
                        {
                            "validation_name": "Validation of document picture alterations",
                            "result": "valid",
                            "validation_type": "fake-picture-validation",
                            "message": "Picture alterations were not found",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:43.587716118Z"
                        }
                    ],
                    "photocopy_analysis": [
                        {
                            "validation_name": "Validation of color photocopy",
                            "result": "valid",
                            "validation_type": "photocopy-validation-color",
                            "message": "The document is not a color photocopy",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:41.318500876Z"
                        },
                        {
                            "validation_name": "Validation of Photocopy Analysis",
                            "result": "valid",
                            "validation_type": "photocopy-validation",
                            "message": "The document is not a photocopy",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:41.066273455Z"
                        }
                    ],
                    "photo_of_photo": [
                        {
                            "validation_name": "Validation of photo of photo",
                            "result": "valid",
                            "validation_type": "photo-of-photo-validation",
                            "message": "The document is not a photo of photo",
                            "manually_reviewed": false,
                            "created_at": "2025-03-20T12:03:42.134537125Z"
                        }
                    ]
                }
            },
            "identity_process_id": "IDP96aXXXXXXXX",
            "attachment_status": "valid",
            "allowed_retries": 2,
            "remaining_retries": 2,
            "front_image": "https://dummy-files.s3/documents-recognition/TCI8abdXXXXXXXX/ACCd64XXXXXXXX/CO/",
            "reverse_image": "https://dummy-files.s3/documents-recognition/TCI8abdXXXXXXXX/ACCd64XXXXXXXX/CO/"
        },
        {
            "validation_id": "VLD770XXXXXXXX",
            "ip_address": "186.XXX.XXX.XXX",
            "account_id": "ACCd64XXXXXXXX",
            "type": "face-recognition",
            "validation_status": "success",
            "threshold": 0.65,
            "creation_date": "2025-03-20T12:03:48.237259292Z",
            "details": {
                "face_recognition_validations": {
                    "enrollment_id": "ENR93aXXXXXXXX",
                    "similarity_status": "success",
                    "age_range": {
                        "high": 32,
                        "low": 24
                    },
                    "confidence_score": 1,
                    "passive_liveness_status": "success",
                    "face_search": {
                        "status": "success",
                        "confidence_score": 0
                    },
                    "speech_match_status": "success"
                }
            },
            "identity_process_id": "IDP96aXXXXXXXX",
            "front_image": "https://dummy-files.s3/face-recognition-validator/pending-enrollments/TCI8abdXXXXXXXX/",
            "face_photo": "https://dummy-files.s3/face-recognition-validator/frames/create-validation/TCI8abdXXXXXXXX/",
            "face_photo_watermark": "https://dummy-files.s3/validation-filters/processed/TCI8abdXXXXXXXX/ACCd64XXXXXXXX/"
        }
    ],
    "last_finished_step": {
        "step_id": "IPSf8bXXXXXXXX",
        "verification_id": "VRF43cXXXXXXXX",
        "type": "enter_face_verification_liveness",
        "verification_output": {
            "status": "success",
            "outputs": [
                {
                    "value": "face-recognition",
                    "name": "validation_type"
                },
                {
                    "value": "VLD770XXXXXXXX",
                    "name": "validation_id"
                },
                {
                    "value": "ACCd64XXXXXXXX",
                    "name": "account_id"
                }
            ],
            "media_uploaded": true,
            "step_data_received": true
        },
        "config": {
            "allowed_document_types": [
                {
                    "country": "ALL",
                    "documents": [
                    ]
                },
                {
                    "country": "CL",
                    "documents": [
                    ]
                },
                {
                    "country": "CR",
                    "documents": [
                    ]
                },
                {
                    "country": "MX",
                    "documents": [
                    ]
                },
                {
                    "country": "BR",
                    "documents": [
                    ]
                },
                {
                    "country": "CO",
                    "documents": [
                    ]
                },
                {
                    "country": "VE",
                    "documents": [
                    ]
                },
                {
                    "country": "PE",
                    "documents": [
                    ]
                },
                {
                    "country": "PA",
                    "documents": [
                    ]
                },
                {
                    "country": "SV",
                    "documents": [
                    ]
                }
            ],
            "retries": 2,
            "face_threshold": 0.65,
            "timeout": 300,
            "liveness_type": "passive",
            "attached_document_ids": null,
            "attached_documents_variables": null,
            "integration_alias": "",
            "manual_review": "default",
            "recorder": "rt-t",
            "sub_validations": [
                "similarity",
                "passive_liveness",
                "speech_match",
                "face_search"
            ],
            "speech_precision": "high",
            "form_message_text": "",
            "form_message_button_text": ""
        },
        "expected_inputs": [
            {
                "type": "hidden",
                "value": "",
                "name": "actions_face_liveness",
                "placeholder": "",
                "description": "",
                "length": 0,
                "read_only": false
            },
            {
                "type": "hidden",
                "value": "0671",
                "name": "speech_token",
                "placeholder": "",
                "description": "",
                "length": 0,
                "read_only": false
            }
        ],
        "files_upload_urls": [
            {
                "name": "face_video",
                "url": "https://files.upload-urls.com/face-recognition-validator/create-validation/TCI8abdXXXXXXXX/ACCd64XXXXXXXX/VLD770XXXXXXXX",
                "description": "Ahora envía un video para validar tu identidad."
            }
        ],
        "remaining_retries": 0,
        "async_step": true,
        "start_date": "2025-03-20T12:03:48.421343206Z",
        "finish_date": "2025-03-20T12:04:25.373050616Z"
    },
    "creation_date": "2025-03-20T12:02:21.125100996Z",
    "update_date": "2025-03-20T12:04:34Z",
    "ab_experiment": "A",
    "ip_address": "186.XXX.XXX.XXX",
    "devices_info": [
        {
            "model": "iPhone",
            "type": "mobile",
            "os": "iOS",
            "browser": "Mobile Safari",
            "browser_version": "18.3",
            "manufacturer": "Apple"
        },
        {
            "model": "Macintosh",
            "type": "computer",
            "os": "Mac OS",
            "os_version": "13.2.1",
            "browser": "Chrome",
            "browser_version": "133.0.0.0",
            "manufacturer": "Apple"
        }
    ],
    "trigger_info": {
        "channel_name": "web",
        "channel_type": "unknown",
        "id": "IPF8daXXXXXXXX",
        "name": "HealthTech",
        "message": "",
        "media_content_path": "",
        "trigger_user": "",
        "response": "",
        "options": null
    },
    "time_to_live": 120,
    "current_step_index": 5,
    "risk_evaluation": {
        "risk_evaluation_id": "VA_RKE_01JPSQ1GNQ5G1HDGPR4KTA3VYK",
        "risk_evaluation_status": "completed",
        "risk_evaluation_result": "not_risky"
    }
}

Process Statuses - The possible states of a process are:

  • Pending - Indicates the process is still ongoing.
  • Success - All steps in the process have been completed successfully. If the flow includes validation steps, all validation statuses are successful.
  • Failure - Can occur if the process is declined or expired, due to a timeout, or because of an internal error.

Notes:

  • If you registered additional information when generating the Web Integration Token, you’ll find it in the metadata section of the response. The following is a partial response showing a metadata section example:
GET
https://api.identity.truora.com/v1/processes/{process_id}/result 
                 
  "metadata": {
      "company": "ACME",
      "field": "Construction"
  }
  • If the final status was manually overridden by an authorized user, the response will contain the fields override_status and override_status_history. Use the override_status instead of status to determine the actual final status of the process. The override_status_history logs all status changes, including timestamps and user details. The following is a partial response showing an example of how status, override_status and override_status_history are returned:
GET
https://api.identity.truora.com/v1/processes/{process_id}/result 
                 
  {
      "status": "success",
      "override_status": "failure",
      "override_status_history": [
          {
              "username": "admin_user@mycompany.com",
              "current_status": "success",
              "override_status": "failure",
              "reason_category": "other",
              "reason_description": "other",
              "date": "2025-03-13T19:56:12.812196504Z",
              "ip_address": "192.XXX.XXX.XXX",
              "files": null
          }
      ]
  }

Devices information

As part of the API response results, you have access to information about the devices used during the identity verification process in the devices_info field. The available data may include the following:

  • model: Model of the device (e.g., iPhone 12).
  • type: Type of device (e.g., mobile, computer).
  • os: Operating system of the device (e.g., Android, macOS, iOS).
  • os_version: Operating system version (e.g., 10.0.0, 13.0.0, 14.3.0).
  • browser: Browser used during the process, (e.g., Chrome, Safari)
  • browser_version: Version of the browser used during the process (e.g., 123.0.0.0, 5.1.7)

You will find two possible scenarios:

  • Scenario 1: Only one device

This case occurs when the entire process is conducted using a single device. In the response, you will receive information similar to the following:

GET
https://api.identity.truora.com/v1/processes/{process_id}/result 
                 
  {
      "devices_info": [
          {
              "model": "SM-N9600",
              "type": "mobile",
              "os": "Android",
              "os_version": "10.0.0",
              "browser": "Chrome",
              "browser_version": "123.0.0.0"
          }
      ],
  }
  • Scenario 2: Two devices involved in the process

An example of this case is when the process initiates on a PC and then continues on a mobile device using the redirection feature. In the response, you will receive information similar to the following:

GET
https://api.identity.truora.com/v1/processes/{process_id}/result 
                 
  {
      "devices_info": [
          {
              "type": "computer",
              "os": "Windows",
              "os_version": "15.0.0",
              "browser": "Chrome",
              "browser_version": "123.0.0.0"
          },
          {
              "model": "SM-N9600",
              "type": "mobile",
              "os": "Android",
              "os_version": "10.0.0",
              "browser": "Chrome",
              "browser_version": "123.0.0.0"
          }
      ],
  }

Get the results of a validation

To get the results of a validation, a validation must have been created and completed. Below are the guides for creating validations based on your integration type:

Note: Whenever a validation fails due to inconsistencies in the validation process or expires in the validation process, the API provides a reason to indicate why the validation was declined or expired:

  • To learn more about the possible declined reasons, please visit the Declined Reasons guide.
  • To learn more about the possible expired reason, please visit the Expired Reasons guide.

From Truora’s Dashboard

Searching validation results

  1. In the Digital Identity dashboard, go to the Results tab in the side menu.
  2. At the top, ensure the VALIDATION RESULTS tile is selected.
Validation results view
  1. Use the Search bar to look up results by Account ID or Validation ID.

Additionally you can apply a Filter to refine your search by:

  • Validation type - Filter the results for a specific validation type. (e.g., Document validation).
  • State - Filter by validation Status: Success, Pending or Failure. If Failure is selected, you may further filter by the Declined Reason.
  • Date Range - Select a date range for search.
Validation results search

Viewing details of a specific validation

To view details about a specific validation, just click on it in the list. The details displayed will depend on the type of validation. The following is a Document validation result example:

validation details example

  • General process details

    • Account ID - The account ID of the user who initiated the process.
    • Validation ID - The unique ID of the validation carried out by the user.
    • Validation date and time - Timestamp of when the validation was performed.
    • Truora processing time - The time used by our system to process the validation.
    • User interaction time - The time used by the user to perform the validation process.

  • Failure, Declination, or Expiration details

    • Failure status - Information on why the validation failed.
    • Declined reason - The reason why the validation was declined.

  • Background Check - In countries where available, a background check is included in document validation (no extra cost). It verifies identity-related datasets only. If a Custom type check has been subscribed and configured (may incur costs), additional datasets are included. The result includes a Check URL linking to the details.

  • Validations performed - Refers to the subvalidations that were used to get to the final validation result.

  • Validations details - At the bottom of the view you will see the details of the validation and its outcome.

Downloading Validations History (CSV)

You can download a CSV file containing a summary of validations results within a specific date range (up to two months).

  1. In Results, click on the Download history button.
  2. Select the time range (Required) - Select a time range up to 2 months.
  3. Select the language (Required) - Choose from English, Spanish, or Portuguese.
  4. Validation Type (Optional) - Optionally, you can choose a validation type to filter results (e.g., Document Validation)
  5. Validation Status (Optional) - Optionally, you can choose to filter results by their Status : Success, Pending or Failure.
Download validation history csv

By means of Truora’s API

Using Truora’s API you should:

  1. Create a GET request to https://api.validations.truora.com/v1/validations/{validation_id}
  2. Replace {validation_id} in the URL with the Validation ID obtained in the request response when you create the validation via API, from Truora’s Dashboard, or by setting up a rule to receive validation updates via Webhooks.
  3. Create a Header named Truora-API-Key and set its value to your API key.
  4. To obtain details such as user inputs or user uploaded media for the validation, add the query parameter show_details set to true to the request.
  5. Send the request. The validation_status begins as pending. Upon completion, the validation can either be success or failure.

Below is an example for a face validation result:

GET
https://api.validations.truora.com/v1/validations/{validation_id} 
                {
    "validation_id": "VLD19XXXXXXXX",
    "ip_address": "186.XXX.XXX.XXX",
    "account_id": "ACC123XXX",
    "type": "face-recognition",
    "validation_status": "success",
    "threshold": 0.65,
    "creation_date": "2024-11-06T16:48:15.055184355Z",
    "details": {
        "face_recognition_validations": {
            "enrollment_id": "ENRc5eXXXXXXXX",
            "similarity_status": "success",
            "age_range": {
                "high": 36,
                "low": 28
            },
            "face_search": {
                "status": "success",
                "confidence_score": 0
            },
            "confidence_score": 1
        }
    },
    "allowed_retries": 2
}

Below is an example of the same face validation result as above, this time with the query parameter show_details=true included:

GET
https://api.validations.truora.com/v1/validations/{validation_id}?show_details=true 
                {
    "validation_id": "VLD19XXXXXXXX",
    "ip_address": "186.XXX.XXX.XXX",
    "account_id": "ACC123XXX",
    "type": "face-recognition",
    "validation_status": "success",
    "threshold": 0.65,
    "creation_date": "2024-11-06T16:48:15.055184355Z",
    "processing_start_date": "2024-11-06T16:48:36.142950387Z",
    "processing_finish_date": "2024-11-06T16:48:40.349433352Z",
    "details": {
        "face_recognition_validations": {
            "enrollment_id": "ENRc5eXXXXXXXX",
            "similarity_status": "success",
            "age_range": {
                "high": 36,
                "low": 28
            },
            "face_search": {
                "status": "success",
                "confidence_score": 0
            },
            "confidence_score": 1
        }
    },
    "validation_inputs": {
        "validation_input_files": [
            "https://dummy-files.s3/face-recognition-validator/TCIXXX/..."
        ]
    },
    "user_response": {
        "input_files": [
            "https://dummy-files.s3/processed/TCIXXX/..."
        ]
    },
    "allowed_retries": 2
}