Guide to Get Results

To get the results of a validation, you must first create and perform the validation. Here are the guides with the types of integration to create the validations:

Note: If the validation fails you can see declined reason for Document validation, Face Validation, Phone validation and Email validation.

Get the results of a process

From Truora’s Dashboard

In Truora’s Dashboard you can filter the results of a process by:

  • The Process ID and Flow ID these is unique identifiers assigned to each process and flow, upon creation or initiation respectively.

  • The Phone Number of the person who initiated or received the WhatsApp message to communicate with the chatbot.

    Within the results of a process, you can find the information of each validation performed and its corresponding outcome.

Digital Identity Verification or Customer Engagement > Results History

result_process_web
  • Another alternative is to download csv file with the history of results that can be filtered by date and/or Flow ID
result_csv

By means of Truora’s API

Using Truora’s API you should:

  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 the Truora’s Dashboard, or by creating a rule to be notified via Webhook .
  3. Create a Header named Truora-API-Key and set its value to your API key.
  4. Send the request. Once you start or finish a process you will be able to see the results. The possible states of a process are success, pending, or failure.

*Note: In the Web Flow test you can get the Process ID in the URL as a path param of the process https://identity.truora.com/{process_id}. (e.g., https://identity.truora.com/IDP58eec9282cxxxxxxxxx).

process_id
Response 200
 
{
  "process_id": "IDP7d087722dbd805447xxxxxxxxxxxxx",
  "account_id": "ACCa3317b7277f7453faxxxxxxxxxxxxxxxx",
  "client_id": "TCI3c204d1cf8e9acd114xxxxxxxxxxxxxx",
  "flow_id": "IPF8bcae1066187e0f02xxxxxxxxxxxxxx",
  "created_via": "web",
  "flow_version": 1,
  "country": "ALL",
  "status": "success",
  "metadata": {
      "name": "juan"
      },
  "validations": [
    {
      "validation_id": "VLDf6e9920fb965xxxxxxxxxxxxx",
      "account_id": "ACCa3317b7277xxxxxxxxxxxxxxxx",
      "type": "phone-verification",
      "validation_status": "success",
      "creation_date": "2023-05-11T21:55:57.314158618Z",
      "remaining_retries": 2,
      "phone": "+57 3180000000"
    },
    {
      "validation_id": "VLD13c616be8233609xxxxxxxxxxxxxxxx",
      "account_id": "ACCa3317b7277f7xxxxxxxxxxxxxxxx",
      "type": "email-verification",
      "validation_status": "success",
      "creation_date": "2023-05-11T21:57:46.014837208Z",
      "remaining_retries": 2,
      "email": "email-address@mail.com"
    }
  ],
  "creation_date": "2023-05-11T21:52:04.619586057Z",
  "update_date": "2023-05-11T21:57:47Z"
}

Note: If you register additional information in the digital validation process token, you can identify it in the JSON under the metadata section.

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:

Response 200
 
  {
      "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:

Response 200
 
  {
      "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

From Truora’s Dashboard

In Truora’s Dashboard you can filter the results by:

  • Type of Validation: Filter the results for a specific validation type. (e.g., Face Recognition).
  • Date: Returns the results in a time interval in the date format YYYY-MM-DD. (e.g., From: 2023-05-01 To: 2023-05-12).
  • Validation Status: The possible states for a validation are success, pending, or failure.
  • Validation ID: The Validation ID is a unique identifier assigned to each validation created, which can be used to retrieve the results of that particular validation.

Digital Identity Verification > Validation results

result_validation_face

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 the API, from the dashboard, or by creating a rule to be notified via Webhook .
  3. Create a Header named Truora-API-Key and set its value to your API key.
  4. Send the request. Once you create the validation you will be able to see the results. The possible validation statuses are success, pending or failure.
Response 200

{
  "validation_id": "VLDb0e61e2bcc591f7a7xxxxxxxxxxxxx",
  "ip_address": "192.168.xx.xx",
  "account_id": "ACCc4d69a60f55be6534xxxxxxxxxxx",
  "type": "face-recognition",
  "validation_status": "success",
  "threshold": 0.65,
  "creation_date": "2023-03-31T22:38:53.981348264Z",
  "details": {
      "face_recognition_validations": {
        "similarity_status": "success",
        "age_range": {
            "high": 37,
            "low": 27
          },
        "confidence_score": 0.84
      }
  }
}