Errors

In this section, you'll find an overview of the errors you may receive on the endpoints of the Unico IDCloud platform

---

Introduction

---

The IDCloud platform uses conventional HTTP response codes to indicate the success or failure of an API request.

As a general rule:

• Codes in the 2xx range indicate that the request was successful;

• Codes in the 4xx range indicate incorrect or incomplete parameters (for example, a mandatory parameter was omitted or an operation failed with a third party, etc.);

• Codes in the 5xx range indicate that there was an error on the Unico IDCloud platform servers.

The Unico IDCloud platform also generates an error message and an error code formatted in JSON:

{
    "error": {
        "code": "0000",
        "description": "error description"
    }
}

Possible errors

---

In this topic, you will find the possible endpoint errors, separated by their HTTP response.

Create Process

---

400 Bad Request

Code	Message	Description
20900	O base64 informado não é válido.	The base64 parameter is invalid. Possible causes: It's not an image or it's an injection attempt.
20807	A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.	The resolution of the uploaded image is too low.
20507	O parâmetro subject.code é inválido.	Non-standard or non-existent CPF.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	When the e-mail address provided is not vThe image is too large. The image can be compressed to JPEG92 without loss of quality.
20505	O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp.	When the phone number entered is not validBase64 invalid. Possible causes: not a valid image or invalid prefix.
20009	O parâmetro imagebase64 não foi informado.	The imagebase64 parameter, which contains the person's selfie, is missing.
20006	O parâmetro subject.name não foi informado.	The subject.name parameter, which contains the person's name, is missing.
20005	O parâmetro subject.code não foi informado.	The subject.code parameter, which contains the person's cpf, is missing.
20004	O parâmetro subject não foi informado.	The subject parameter, which contains the person's data (cpf, name), is missing.
20003	The request body is missing or invalid.	Null or invalid payload.
20002	O parâmetro APIKey não foi informado.	The APIKEY parameter is missing from the request header.
20001	O parâmetro authtoken não foi informado	The integration token parameter is missing from the request header.
10508	The JWT with the captured face has already been used.	The jwt can only be used once.
10507	The JWT with the captured face is expired.	JWT expired. The .jwt must be sent within 10 minutes.
10506	The bundle is invalid.	Invalid bundle. APIKEY uses a security method and this request does not meet the security requirements (SDK).

403 Forbidden

Code	Message	Description
30017	Jwt header is an invalid JSON.	When the access-token used contains wrong characters.
10502	O token informado está expirado.	When the access-token used has expired
10501	O token informado é inválido.	The authentication token is invalid.
10201	O AppKey informado é inválido.	The APIKEY parameter has not been entered or does not exist.

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	When there is an internal error.

Consult Process Results

---

400 Bad Request

Code	Message	Description
20023	O parâmetro processId não foi informado.	The process id parameter is missing.
20002	O parâmetro APIKey não foi informado.	The APIKEY parameter is missing from the request header.
20001	O parâmetro authtoken não foi informado.	The integration token parameter is missing from the request header.

404 Not Found

Code	Message	Description
50001	O processo informado não foi encontrado.	The process does not exist in the database.

403 Forbidden

Code	Message	Description
30017	O usuário não tem permissão para executar está ação.	When the access-token used contains wrong characters.
10502	O token informado está expirado.	When the access-token used has expired.
10501	O token informado é inválido.	The authentication token is invalid.
10201	O AppKey informado é inválido.	The APIKEY parameter has not been entered or does not exist.

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	When there is an internal error.

---

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.