HTTP Status Codes
Requests to Datavalid may return the following HTTP codes:
Billing
The following return code is charged in billing: 200 (OK)
The following return codes won't be charged in billing: 204 (No Content), 400 (Invalid Requisition), 401 (Unauthorized), 403 (Forbidden), 413 (Request Entity Too Large), 422 (Unprocessable Entity), 500 (Server Error), 502 (Bad Gateway), 503 (Service Unavailable) e 504 (Gateway Timeout)
Code / Responses
200 OK
Everything worked as expected and the data validation was performed successfully.
204 No Content
The server successfully fulfilled the request and there is no additional content to send in the response.
400 Invalid Request
The request was not accepted because there is some inconsistency in some fields of the request. Check if the properties of the request body are in accordance with the expected properties of the method. Also, verify if the request body is encoded in UTF-8.
401 Unauthenticated
Problems during the authentication.
403 Unauthorized
Problems during the authorization.
413 Request Entity Too Large
The request is too big. The maximum request size limit is 3MB. Verify that the maximum request size limit is being met.
422 Unprocessable Entity
Validation cannot be processed because there is an invalid character in the request. Invalid characters are listed in the response.
Code | message |
---|---|
DV001 | LGPD: Minors’ data validation not allowed by LGPD |
DV002 | Data found in the database does not meet the minimum requirements for validation Since 20/03/2023, Datavalid answers the return code HTTP 422 - DV002 for cases which the data found in Senatran database do not meet the minimum validation requirements. Aiming at greater effectiveness and safety to the digital identity validation process, Datavalid's Quality Checker verifies the quality of the images before facial validation. Importantly, this type of return will not be invoiced because it is an unqualified request (return: error http 422-DV002 ). |
DV010 | Invalid CPF |
DV011 | Invalid nationality |
DV012 | Invalid document type |
DV013 | Invalid gender |
DV014 | Invalid CPF status code |
DV016 | Invalid CNH status code |
DV017 | Invalid description of the CNH status |
DV018 | Invalid UF |
DV020 | Invalid CNPJ |
DV021 | Invalid registration status code |
DV022 | Invalid size |
DV030 | Invalid fingerprint position |
DV031 | Invalid fingerprint format |
DV032 | Error retrieving digital image encoded in base64 |
DV033 | Image of fingerprint corrupted or out of JPG, PNG or WSQ format |
DV034 | Low fingerprint image quality |
DV035 | Invalid fingerprint image size |
DV036 | Fingerprint position duplicated |
DV040 | Face image not found in the databases |
DV041 | It was not possible to recognize the face in the image |
DV042 | Invalid face image size |
DV043 | Face image corrupted or out of JPG or PNG format |
DV044 | Error retrieving base64 encoded face image |
DV045 | Poor face image quality |
DV046 | More than one face was recognized in the image |
DV047 | Invalid face image format |
DV079 | Mandatory document |
DV080 | Invalid document format |
DV081 | Error retrieving base64 encoded document |
DV082 | Document file corrupt or not in expected format |
DV083 | Invalid document size |
DV084 | The document provided was not recognized as valid |
DV085 | More than one document was recognized |
DV086 | Unable to retrieve CPF in the document |
DV087 | Unable to retrieve face photo in document |
DV088 | The CPF entered does not belong to the CPF of the document |
DV089 | Number of valid fields retrieved from the document is not enough to validate the document |
500 Server Error
Some internal error occurred on the server.
502 Bad Gateway
This error message is displayed when there is an issue with generating tokens.
503 Service Unavailable
Internal server error. Some services integrated with Datavalid are currently unavailable.
code | message |
---|---|
DVxx | Some services integrated with Datavalid are currently unavailable. |
504 Gateway Timeout
The gateway did not answer promptly due to a network error.