GetSelfie

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

---

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;

• Production: https://api.cadastro.unico.app/client/v1/process.

---

GetSelfie

Endpoint to retrieve the selfie from the Unico process. The optional raw=true parameter can be used to obtain the raw file.

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

The parameter [?raw=true] is optional. If your service account has the necessary permission, you can use it to obtain the selfie without the watermark.

For detailed verification of the API parameters, please refer to the Parameters Specification section.

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.