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:

• Document Validation from web process and via API.
• Face Validation from web process and via API.
• Document and Face Validation from web process and via API.
• Phone Validation from web process and via API Phone
• Email Validation from web process and via API Email.
• WhatsApp to Validate Identity, all Digital Identity validators (Document, Face, Phone and Email).
• Electronic Signature from web and WhatsApp process. Via API.

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 the 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

• By means of Truora’s API:

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": "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.

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

Get the results of a validation

• From the 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

• By means of Truora’s API:

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.

 
{
  "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
      }
  }
}