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 Get User Selfie endpoint works in by Unico. This endpoint will provide the user's selfie, with a watermark, from completed processes, allowing you to use it as support in cases of disputes by the user.

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;

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

---

Obtaining User Selfie

---

GetSelfie

get

Endpoint to retrieve the selfie from the Unico process.

Path parameters

idstringRequired

Process ID.

Query parameters

rawbooleanOptional

Optional flag to return the raw selfie file.

Example: true

Responses

200

Selfie obtained successfully.

application/json

400

When the process ID is invalid.

application/json

401

Error in access-token.

application/json

403

When the service account does not have permission to obtain the selfie.

application/json

404

When it was impossible to find the process.

application/json

500

Unexpected error (internal error or parameter issue).

application/json

get

HTTPcURLJavaScriptPython

GET /client/v1/process/{processId}/selfie HTTP/1.1
Host: api.cadastro.uat.unico.app
Accept: */*

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

For more information about the possible errors for this endpoint, refer to the Errors section.

---

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.