Response Codes

This page provides the list of response codes of OpenAPI in Liveness.

OpenAPI HTTP response codes

HTTP CodeMessageDescription
200OKThe request has succeeded.
400Bad RequestThe request could not be understood by the server due to incorrect syntax.
401UnauthorizedThe request requires user authentication information with an Authorization header field.
405Method Not AllowedThe request HTTP method is disabled and cannot be used for that resource.
413Request Entity Too LargeRequest entity is larger than limits defined by the server. (the request body should be smaller than 5MB)
414Request-URI Too LongThe URI requested by the client is longer than the server can interpret. (8k)
415Unsupported Media TypeThe media-type in Content-type of the request is not supported by the server.
429Too Many RequestsThe user has sent too many requests in a given amount of time. (refer to the limit in your business plan)
431Request Header Fields Too LargeThe header field is longer than the server can interpret. (25KB)
500Internal Server ErrorThe server encountered an unexpected condition that prevented it from fulfilling the request.
502Bad GatewayThe server got an invalid response while working as a gateway to get the response needed to handle the request.
503Service UnavailableThe server is not ready to handle the request.
504Gateway TimeoutThe server is acting as a gateway and cannot get a response in time for a request.

Error codes of 400

codemessagedescription
110body_parameter_missingA body parameter is missing
111body_parameter_invalid_typeThe type of a body parameter is not valid
112body_parameter_invalid_valueThe value of a body parameter is not valid
113body_parameter_not_foundThe value of a body parameter cannot be found
116body_parameter_duplicatedThe value of a body parameter is not unique
215image_data_not_supportedThe format of the image is not supported
219image_data_too_fewThe number of the images input is too few
223image_entity_not_foundThe entity (face) is not found in the image