GetEvidenceSet

In this section, you will find instructions on how to obtain the evidential set from a process in by Unico via the REST API

---

Introduction

---

In this section, you will find detailed documentation on how the Proof Set Retrieval endpoint works in by Unico. This endpoint will provide the proof set of the completed biometric transaction, allowing you to store it for potential future disputes by the end user.

To learn more about the proof set, see the Specification if the evidenctial section.

Getting started

---

Your API requests are authenticated using an access token. Any request that does not include a valid access token will return an error.

You can learn more about generating an access token here.

Endpoints:

• UAT: https://api.cadastro.uat.unico.app/client/v1/process;

• Produção: https://api.cadastro.unico.app/client/v1/process.

---

GetEvidenceSet

Endpoint to retrieve the evidence set from the identity verification process by Unico.

GEThttps://api.cadastro.uat.unico.app/client/v1/process/{id}/evidenceset

Authorization

bearerAuth

Path parameters

id*string

Process ID.

Response

200400401404500

Evidence set obtained successfully.

Body

application/json

fileContentsstring

Evidence content encoded in base64.

Example: "JVBERi0xLjUNCiWDk[...]NCg=="

contentTypestring

Type of the evidence content (PDF).

Example: "x-pdf"

Request

JavaScriptCurlPython

const response = await fetch('https://api.cadastro.uat.unico.app/client/v1/process/{id}/evidenceset', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200400401404500

{
  "fileContents": "JVBERi0xLjUNCiWDk[...]NCg==",
  "contentType": "x-pdf"
}

Processes must be created exclusively through backend-to-backend communication, due to our CORS policy, which prevents processes from being created through frontend-to-backend communication.

The evidential set from the biometric capture is only available for consultation via the REST API for 2 hours after the completion of the biometric process. After this period, it is no longer possible to retrieve the user's selfie.

---

Still need help?​

Didn't find something or still need help? If you're already a client or partner, you can reach out through our Help Center.