GetSelfie

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

---

Introduction

---

In this section, you will find detailed documentation on how the User Selfie Retrieval endpoint works in by Unico. This endpoint provides the user’s selfie, with a watermark, from completed processes, allowing you to use it as support in cases of user disputes.

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.

---

GetSelfie

Endpoint to retrieve the selfie from the Unico process.

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

Path parameters

id*string

Process ID.

Query parameters

Response

200400401403404500

Selfie obtained successfully.

Body

application/json

fileContentsstring

Content of the selfie encoded in base64.

Example: "/9j/4AAQSkZJRgABAQA[...]QkeQUjE"

contentTypestring

Type of the image content (jpeg or png).

Example: "image/jpeg"

Request

JavaScriptCurlPython

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

Response

200400401403404500

{
  "fileContents": "/9j/4AAQSkZJRgABAQA[...]QkeQUjE",
  "contentType": "image/jpeg"
}

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.

Important:

• The permission to obtain the user's selfie will depend on Unico's internal evaluation. Understand with the person responsible for your project whether you will be able to consume this service;

• It is only possible to get the selfie with the watermark;

• The user’s selfie is only available for consultation via REST API for 8 hours after the biometric process is completed. After this period, it is not 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.