Skip to content

API errors#

The section describes errors, returned by the API service. Each of the errors has a unique code. This section also includes a description of CORE errors returned by the API service. The errors can have different reasons and appear in several different CORE services. In this case, it is recommended to check service logs to find out where the error occurs.

General connection errors#

Error code Error Message Error Description
0 Success Success This code is returned when there are no errors and the request is successfully processed.
1 Internal server error Unknown error Internal error. Cause unknown.
2 Queue request timeout Request timeout to routing key {value} MQ connection limit exceeded (Request timeout parameter). Check MQ availability.
3 Invalid url {value} Invalid URL.
4 Client payload error {value} Client payload error. Possible causes: the response object was closed before the response received all data, transfer encoding error occurred.
5 Server fingerprint mismatch {value} Server fingerprint error. Attempt to connect to an invalid server, or invalid key used.
6 Socket read timeout Request timeout on {value} method {value} Socket reading error. Request completion time limit exceeded.
7 Socket connect timeout Request timeout on {value} method {value} Socket connection error. Request completion time limit exceeded.
8 Connect timeout Connect timeout on {value} method {value} Connection error. The connection time limit exceeded.
9 Request timeout Request timeout on {value} method {value} Connection error. Request completion time limit exceeded.
10 Server disconnected {value} The connection with the server is lost.
11 Server connection error {value} Server connection error.
12 Client proxy connection error {value} Client proxy connection error.
13 Client connector SSL error {value} Client connection via SSL error.
14 Client connector certificate error {value} Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version.
15 Client SSL error {value} Client SSL error. Possible causes are: invalid SSL certificate, outdated client SSL version.
16 Client connector error {value} Client connection error.
17 Client OS error {value} The error in the operating system has occurred.
18 Client connection error {value} Client connection error.
19 Client HTTP proxy error {value} The HTTP proxy server error has occurred on the client-side.
20 WS server handshake error {value} The connection through web sockets failed.
21 Content-Type error {value} Request content error. Invalid value in Content-Type field of request header parameters. See "HEADER PARAMETERS" in the API documentation.
22 Client response error {value} The client response error has occurred.
23 HTTP client error {value} Client HTTP error.
24 HTTP client error {value} Client HTTP error. The response received in the incorrect JSON format.

CORE errors, returned in API responses#

Error code Error Message Error Description
100 Bad/incomplete configuration {value} Cannot read the configuration file, or invalid file name.
101 Bad/incomplete query {value} Invalid request parameters or mandatory parameters are absent. See "QUERY PARAMETERS" in the API documentation.
102 Bad/incomplete body {value} Invalid request body. See "REQUEST BODY SCHEMA" in the API documentation.
105 Out of memory {value} Not enough memory.
106 Invalid http request {value} Invalid HTTP request. Make sure the request URL is correct.
200 Generic error {value} Generic error: invalid parameter, logical errors.

Message subsystem#

Error code Error Message Error Description
2000 Bad/incomplete message package {value} Empty or unreadable message received from MQ.
2001 Bad/unsupported message content type {value} Invalid MQ message content type. The body is not in the JSON format.
2002 Failed to call a remote worker {value} The connection to MQ worker failed.
2003 Failed to call a driver method {value} The connection to MQ failed.
2004 Generic MQ error {value} MQ error.
2101 Data not ready {value} The task result has not yet returned to MQ.
2102 Driver is stopped {value} The MQ driver has stopped.
2103 Max amount of messages in a queue exceeded {value} MQ limit exceeded.
2104 Queue driver call failed {value} Failed to call the MQ driver.
4003 No faces found No faces found. There are no faces found

Descriptor Match#

Error code Error Message Error Description
5003 Failed to match descriptors {value} Failed to perform matching due to invalid descriptor. Matcher error.
5004 Bad/incomplete input data {value} Invalid request content. Matcher error.
5005 Invalid config {value} Invalid Matcher configuration file. Matcher error.
5101 Reference UUID is missing Reference uuid is missing Reference UUID not found. Matcher error.
5102 Reference UUID has no extracted descriptor Reference uuid has no extracted descriptor The extracted descriptor for Reference UUID not found. Failed to match the descriptor. The descriptor was extracted with an outdated neural network version. Matcher error.
7001 Bad/unsupported API version {value} Invalid API version specified in the request.

Database Errors#

Error code Error Message Error Description
10015 SQL request execution failed SQL request failed. A database error has occurred. The database is not available for an unknown reason, or the required tables are missing. You should request the status of the database, check the availability of the database over the network, check the existence of the required tables in the database.
10016 Database error Could not connect to database The connection to the database failed.
10017 DataBaseConnectionTimeoutError Database connection timeout error.

API errors#

Error code Error Message Error Description
11002 Authorization failed Account corresponding login/password not found The account was not found for Backport 3. There is no account with the provided login/password.
11004 Account is suspended Account is suspended The account is not active (Backport 3).
11009 Internal server error Internal server error The error occurs when an unknown exception comes to the REST resource handler level.
11011 Unique constraint error An account with given email already exists The account with given email already exists .
11012 Extract policy error {value} An error occurred during extraction. There are several faces in the image (Backport 3).
11018 Object not found Descriptor with id ‘{value}’ not found The descriptor with the given ID was not found (Backport 3).
11020 Object not found One or more {value} not found One or more of the specified objects were not found. You should check their existence.
11022 Object not found Token not found The token was not found for Backport 3
11027 External request failed Failed to download image by url {value} The external request has failed. Failed to get the image by the URL specified in the request body.
11028 Bad/incomplete input data Bad content type of image {value} Invalid image content-type in the request.
11029 Bad/incomplete input data Bad content type of image in multipart body There is an invalid image content-type in the request, which contains several images. One or several images have an invalid format or size.
11030 Bad/incomplete input data Image size is not equal to 250x250 The size of the normalized image in the request is not equal to 250x250. The image is not a sample.
11031 Bad/incomplete input data Sample with id {value} not found The sample with the specified ID was not found. You should check the ID in the request.
11032 Object not found Face with id {value} does not have attributes yet The Face with the specified ID has no attributes. The error occurs when matching is performed for a Face without attributes.
11034 Bad/incomplete input data Descriptor for attribute {value} was not extracted The descriptor for the specified attribute was not extracted. You should verify the correctness of the "attribute_id" in the request.
11035 Service name not found Service name {value} not found The specified service name was not found.
11036 Forbidden Luna-Account-Id header is required for requests which change the state of system It is required to specify the correct "Luna-Account-Id" header in the request. The header defines a user who changes the state of the system. Perhaps, the user without access to the database was specified.
11037 Bad/incomplete input data Luna-Account-Id header is not UUID4 format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx The "Luna-Account-Id" header in the request is not in UUID4 format, the required format is xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxxxx.
11038 Multiple faces found Multiple faces found in image {value} detect {value} There is more than one person in the image. The policy of processing images with a single face is specified in handler parameters.
11039 Forbidden Luna Tasks service is disabled A request to the Tasks service cannot be processed. Using the Tasks service is disabled in the API configuration. Check the LUNA_TASKS_SUPPORT parameter in "/var/lib/luna/current/luna-api/luna_api/configs/config.conf".
11040 Forbidden Luna Events service is disabled The request to the Events service cannot be processed. The use of the Events service is disabled in the API configuration. Check the LUNA_EVENTS_SUPPORT parameter in "/var/lib/luna/current/luna-api/luna_api/configs/config.conf".
11041 Object not found No one face found with external id {value} The face object with the specified external ID was not found.
11042 Unhandled exception: {value} An unhandled exception occurred
11043 Bad/incomplete input data Bad or incomplete input data is provided for the warped image in the request
11044 turned off for LUNA API instance The process is turned off for the API instance. Check API configurations.
11045 Only one detection rectangle is available for each image at the moment Only one detection rectangle is available for each image at the moment
11046 Several files with name {value} were found Several images with the same name were sent in the request. The images must have unique names
11047 Bad/incomplete input data Bounding box is not available for warped images The bounding box is not available for warped images
11048 There is more than a single bounding box specified in the request There is more than a single bounding box specified in the request. A single bounding box can be specified for an image
11049 Bad/incomplete input data {value} Bad or incomplete input data is provided in the multipart request. Not enough information about the image is given in the request.
11050 More than one bounding box for image named {value} was found The image has several bounding boxes.
11051 Service static folder was not loaded The service static directory was not loaded
11052 No attribute was specified for the extraction No attribute was specified for extraction. You should specify at least one attribute ID in the request.
11053 Multiple human bodies found Multiple human bodies found in image {value} detect {value} There are several human bodies found in the image
11054 Forbidden Liveness service is disabled The Liveness request cannot be processed as Liveness feature is not available. Check your license.
11055 Forbidden License problem: ‘{value}’ License error. The license has expired or is unavailable.
11056 Bad/incomplete input data {value} The request in invalid. The request data is incomplete.

Rest API common errors#

Error code Error Message Error Description
12001 Bad/incomplete input data Object in query is not UUID4 format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx The provided ID for the object is not in UUID4 format.
12002 Bad/incomplete input data Request does not contain json The request does not contain JSON. You should check the JSON syntax in the request body: there are extra symbols, the JSON structure was broken, or important syntax elements were missed.
12003 Bad/incomplete input data Field {value} not found in json The specified field was not found in the JSON body. You should check that all required fields were added to the request.
12005 Bad/incomplete input data Request contain empty json The request contains an empty JSON body. A body is required to execute the request.
12010 Bad/incomplete input data This resource needs Authorization authorization headers You should specify the "Authorization" header in the request.
12012 Bad/incomplete input data Bad query parameters {value} The specified query parameters are set incorrectly.
12013 Resource not found Page not found The HTTP resource was not found. The URL specified in the request was not found. For example, the request contains the path "/ 5 / sample" instead of "/ 5 / samples". You should compare the specified path with the path in the documentation.
12014 Bad/incomplete input data Required parameters {value} not found The required query parameters were not found in the request. These parameters are listed in the error.
12016 Bad/incomplete input data No one parameters {value} not found Listed query parameters were not found in the request. You should check, which parameters are required, in the documentation "APIReferenceManual.html".
12017 Bad/incomplete input data Bad content type Invalid "Content-Type" header value transmitted in the request. No header was specified, an invalid header value was specified, or there is a mistake in the header.
12018 Bad/incomplete input data Unsupported param ‘{value}’ The query parameter is unsupported
12021 Method not allowed Method not allowed The HTTP resource does not support this method. You should check the HTTP method specified to send the request.
12022 Bad/incomplete input data Failed to validate input json. Path: {value} message: {value} There is an error in JSON syntax at the specified path. The request body contains invalid fields. You should check the request for compliance with the template specified in the documentation "APIReferenceManual.html". The detailed description of the error is given in the field "message".
12023 Bad/incomplete input data The input data content type is not acceptable the allowed content types: The request contains invalid data. Most likely, there is a typo in the request.
12024 Bad/incomplete input data Unsopported media type The data type transmitted in the request is not supported.
12025 Bad/incomplete input data Specified content type does not match data type The content-type specified in the "Content-Type" header does not match the data type.
12027 Bad/incomplete input data Failed to validate input json. Message: {value} The request body parameters are incorrect. You should check the JSON body for compliance with the request requirements. Details are listed in the "Message:" field.
12028 Bad/incomplete input data Failed to parse Flatbuf Internal error. Failed to deserialize Flatbuf.
12029 Functionality is not implemented Required server functionality is not implemented The requested server functionality is not implemented.
12030 Bad/incomplete input data Request does not contain data The request contains no data. The request body is empty.
12031 Bad/incomplete input data {value} The input data is incomplete or wrong
12032 Internal server error Document with name ‘{value}’ not found The document with the specified name was not found
12033 Forbidden Access to this resource on the server is denied The access to the resource on the server is denied
12034 Bad/incomplete input data Descriptor has incorrect length {value} The descriptor has an incorrect length
12035 Bad/incomplete input data Failed to parse xpk file Failed to parse XPK file
12036 Bad/incomplete input data Descriptor version {value} is not registered in the system The specified descriptor version is not registered in the system. You set a wrong version or use an incompatable service version.
12037 Bad/incomplete input data XPK file does not contain descriptor The input data XPK does not contain a descriptor
12038 Bad/incomplete input data SDK descriptor is not valid SDK descriptor is not valid.
12039 Bad/incomplete input data Unknown multipart name ‘{value}’ There is an unknown name in the multipart request
12040 Bad/incomplete input data Duplicate multipart name ‘{value}’ There is a duplicated name in the multipart request
12041 Bad/incomplete input data Multipart with name ‘{value}’ has bad Content-Type The input data with the specified name has bad Content-Type in the multipart request
12042 Gone Access to this resource on the server is no longer available The access to the resource on the server is not available
12043 Unknown error Service ‘{value}’ unknown error method: ‘{value}’ url: ‘{value}’ Unknown service error has occurred. See the provided method and URL.
12044 Bad/incomplete input data Failed to decompress input body using gzip encoder Failed to decompress input body using gzip encoder.
12045 Bad/incomplete input data Failed to decompress input body using deflate encoder Failed to decompress input body using deflate encoder

Image Store service errors#

Error code Error Message Error Description
13003 Object not found Image with id {value} not found The image with the specified ID was not found.
13004 Bad/incomplete input data Image count exceeded limit 1000 The number of images in the deletion request exceeded the limit of 1000.
13005 Object not found Bucket with name {value} not found The specified bucket was not found. You should check the existence of the bucket. The path to the bucket is specified in the Image Store configuration file in the "LOCAL_STORAGE" variable. If there is no bucket, you should manually create it using the command specified in the LUNA PLATFORM installation manual. "
13006 Unique constraint error Bucket with name {value} already exist A bucket with the specified name already exists. The error occurs when trying to create two buckets with the same name.
13007 Object not found Object with id {value} not found The object with the specified ID was not found in the bucket. The object does not exist or there is a typo in the ID.
13008 Unique constraint error Object with id {value} already exist An object with the specified ID already exists in the bucket.
13009 Bad/incomplete input data Object count exceeded limit 1000 The number of objects transferred to the bucket exceeded the limit of 1000.

Admin service errors#

Error code Error Message Error Description
15012 Object not found Account with id ‘{value}’ not found There is no account with the specified «Luna-Account-Id»
15013 Unique constraint error Account with same email or id already exist The e-mail with the specified «Luna-Account-Id» already exists.
15014 Bad/incomplete input data Login or password is incorrect Bad input. The login or the password is incorrect.

Image Processing Errors#

Error code Error Message Error Description
18001 Bad/incomplete input data Failed convert data from base64 to bytes Failed to convert BASE64 string to bytes. The error is in BASE64.
18002 Bad/incomplete input data Failed convert bytes to jpg Failed to convert bytes to JPG image. The request does not include a photo image.
18003 Bad/incomplete input data Failed read bytes as image The image bytes cannot be read

Image Store Service Errors (Hard Disk)#

Error code Error Message Error Description
19001 Internal server error Failed to save image in the storage Image Store could not save an image to the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19002 Internal server error Failed to remove image from the storage Image Store could not delete an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19003 Internal server error Failed to remove image from the storage Image Store could not delete images from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19004 Internal server error Failed to create bucket Image Store could not create a bucket from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19005 Internal server error Failed to get bucket list Image Store could not get a list of buckets on the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19006 Internal server error Failed to get image from the storage Image Store could not get an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19007 Internal server error Failed to save object in the storage Image Store could not get an image from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19008 Internal server error Failed to remove object from the storage Image Store could not delete an object from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19009 Internal server error Failed to remove objects from the storage Image Store could not delete objects from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19010 Internal server error Failed to get object from the storage Image Store could not get an object from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19011 Internal server error Failed to get objects from the storage Image Store could not get objects from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.
19012 Internal server error Failed to delete bucket Image Store could not delete a bucket from the hard disk. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the disk, a problem in Image Store.

Image Store Service Errors (S3 storage)#

Error code Error Message Error Description
20001 Internal server error Failed to save image in the storage Image Store could not save an image to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20002 Internal server error Failed to remove image from the storage Image Store could not delete an image from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20003 Internal server error Failed to remove image from the storage Image Store could not delete images from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20004 Internal server error Failed to create bucket Image Store could not create a bucket in the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20005 Internal server error Request to S3 Failed Failed to complete the request to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20006 Internal server error Request to S3 Forbidden Failed to get access to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20007 Internal server error Request time to S3 is longer than the established time Request time to the S3 storage exceeded the specified limit. Check the storage availability. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20008 Internal server error S3 Connection Refused Connection to the Image Store (S3) was refused. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20009 Internal server error Connect time to S3 is longer than the established time Connection time to the S3 storage has exceeded the specified limit. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20010 Internal server error Unknown s3 error An unknown S3 storage error occurred. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20011 Internal server error Failed to get bucket list Image Store could not get a list of buckets from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20012 Internal server error Failed to get image from the storage Image Store could not get an image from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20013 Internal server error Failed to save object in the storage Image Store could not save an object to the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20014 Internal server error Failed to remove object from the storage Image Store could not delete an object from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20015 Internal server error Failed to remove object list from the storage Image Store could not delete a list of objects from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20016 Internal server error Failed to get object from the storage Image Store could not get an object from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20017 Internal server error Failed to get object list from the storage Image Store could not get objects from the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20018 Internal server error Failed to delete bucket Image Store could not delete a bucket form the S3 storage. You should check the Image Store service logs. The error may occur for the following reasons: denial of access, inaccessibility of Image Store over the network, a problem with the storage, a problem in Image Store.
20019 Bad/incomplete query Failed to create bucket with specified name The bucket with the given name cannot be created.

Faces service errors#

Error code Error Message Error Description
22001 Unique constraint error Face with the same attribute_id already exists It is unable to create a Face based on the attribute specified in the "attribute_id" field in the request. A Face with this attribute already exists. An attribute can be attached to only one face.
22002 Object not found Face with id {value} not found The Face with the specified "face_id" was not found. A typo was made in the "face_id" field or a Face with such an ID does not exist.
22003 Object not found List with id {value} not found The List with the given ID was not found. You should specify an existing List in the request.
22004 Object not found One or more faces not found including face with id {value} One or more Faces were not found, including the Face with the specified ID. A typo was made in the "face_id" field or the Face with such an ID does not exist.
22005 Object not found One or more lists not found including list with id {value} One or more Lists were not found, including the List with the specified ID. The specified Lists do not exist. You should specify an existing list in the request.
22007 Object not found Person with id ‘{value}’ not found The person with the given ID was not found in the database.
22008 Unique constraint error This face is already attached to the person The face is already attached to a person.
22009 Bad/incomplete configuration Face avatar url is not correct The URL in the "avatar" field in the request is incorrect.
22010 Object not found Attributes with id {value} for update not found An error occurred while updating the fields of the existing Face. The "attribute_id" field in the request is invalid. The attribute with the specified ID was not found.
22011 Object not found Attributes with id {value} not found Attributes with the specified ID were not found in the database. You should specify an existing "attribute_id" in the request.
22012 Bad/incomplete input data Failed to decode descriptor from base64 Failed to decode the descriptor from the BASE64 format. It is a software Error.
22013 Bad/incomplete input data Failed to encode descriptor to base64 Failed to encode the descriptor to the BASE64 format. It is a software Error.
22015 Conflict input data Attribute {value} generation should be {value} but {value} was provided The attribute generation does not match the provided one. The error occurs upon the extraction of the descriptor of a new version. The source descriptor was updated, so the descriptor of a new version cannot be added to the database.
22016 Bad input data ‘{value}’ is not valid target to get faces. Valid target should be one of {value}. The invalid value is specified in the «target» request parameter.
22017 Bad/incomplete input data Match reference must be specified either as (descriptor) or (attribute_id) or (face_id) The reference for matching must be specified as a descriptor, an attribute ID, or a face ID.
22018 Object not found Descriptor of version {value} is not found for object with id ‘{value}’. There is no descriptor with the specified version for the object with the specified ID.
22020 Internal server error Corrupted attribute with id ‘{value}’ The attribute with this ID is corrupted.
22021 Integrity error Attribute with id ‘{value}’ already exist The attribute with the specified ID already exists.
22022 Bad input data Attribute does not contain ‘descriptors’ and ‘basic_attributes’ The attribute does not contain any data: ‘descriptors’ or ‘basic_attributes’.
22023 Bad input data Attribute contains ‘{value}’ samples but corresponding attributes is empty The attribute contains samples without data.
22024 Bad input data Attribute contains descriptors of identical versions: ‘{value}’ The attribute contains descriptors of the same version.
22025 Conflict input data Attribute samples of existing face (with face_id {value}) do not match specified samples The attribute samples of the face with the specified face_id do not match specified samples
22026 Unique constraint error List with id ‘{value}’ already exist The list with the specified ID already exists and cannot be created.

Events service errors#

Error code Error Message Error Description
23001 Object not found Event with id {value} not found The event with the specified ID was not found by Events service. The event does not exist.
23002 Object not found One or more events not found including event with id {value} One or more events were not found by Events service, including the specified event. The events do not exist.
23003 Unique constraint error One or more event id from {value} already exist One or more event IDs from the list already exist.
23004 Unique constraint error One or more attribute id from ‘{value}’ already exist One or more listed Attribute ID already exists.
23005 Bad input data ‘{value}’ is not valid target to get events. Valid events should be one of {value} The specified target is not valid. Specify one of the available targets.
23006 Internal server error Timeout ({value} seconds) for save events into history database has been expired The timeout for saving events into the database has been expired
23007 Object not found Human descriptor of version {value} is not found for object with id ‘{value}’. Human descriptor was not found for the object.
23008 Internal server error Copywriter queue is full Copywriter queue is full
23009 Internal server error Events are shutting down Events are shutting down
23010 Internal server error Events saving failed reason: {value} The saving of an event failed due to an internal server error.

Index services error#

Error code Error Message Error Description
26001 Object not found Index task not found Index task was not found.
26002 Internal server error Generation not found in indexer The generation was not found in Indexer service
26003 Internal server error Not expected status of indexer Indexer has unexpected status.
26004 Internal server error Failed start upload generation {value} on daemon {value} reason: {value} The generation was not uploaded on the specified daemon. The reason is given.
26005 Internal server error Failed start reload generation {value} on daemon {value} reason: {value} The generation was not reloaded on the specified daemon. The reason is given.
26007 Internal server error Not expected status of upload task. Status: {value} daemon: {value} generation: {value} An unexpected status of the upload task was returned.
26008 Internal server error Not expected status of restart task. Status: {value} daemon: {value} generation: {value} An unexpected status of the restart task was returned.
26009 Bad/incomplete input data List does not satisfy to the indexation condition The list does not match the specified indexation conditions.

Configurator service errors#

Error code Error Message Error Description
27001 Object not found Setting with id {value} not found The setting with the specified ID was not found.
27002 Integrity error Setting with the following fields already exists: name: {value} tag: {value} The setting with the specified fields does not exist. The name and tag pair should be unique in the database.
27003 Bad/incomplete input data Connection check to service is failed The request for the specified service URL failed.
27004 Bad/incomplete input data Not allowed to change tags for default setting You cannot create a tag for the default setting. The default setting can't have a tag.
27005 Bad/incomplete input data Tag {value} for setting {value} not found There is no specified tag for the specified setting.
27006 Object not found Limitation named {value} not found The newly created setting should match the configuration template (limitation) that is set for it. A description of the configuration template is provided in the user interface and documentation.
27007 Integrity error Limitation named {value} already exists When creating a new template for the settings (limitation) you used the name of an existing template.
27008 Object not found Group named ‘{value}’ not found The Group object with the specified name was not found.
27009 Object not found One or more groups not found including group named ‘{value}’ One or several Group objects were not found, including the object with the specified name.
27010 Integrity error Group named ‘{value}’ already exists The Group object with the specified name already exists.
27011 Bad/incomplete input data Cannot remove default setting ‘{value}’ It is unavailable to delete the default setting from the Configurator settings.
27012 Bad/incomplete input data Not allowed to change default setting name Error when trying to change the default setting name. It is not allowed to change the default setting name

Tasks service errors#

Error code Error Message Error Description
28000 Network error Cannot send subtasks to task_workers. Reason: {value} Failed to send subtasks to Tasks service handlers. The reason is shown in the "Reason" field.
28001 Object not found Task with id {value} not found The task with the specified ID was not found by Tasks service. The identifier was set incorrectly or the task with the specified identifier was deleted.
28002 Object not found One or more tasks not found including task with id {value} The Tasks service did not found the specified tasks, including the task with the specified ID. The ID is set incorrectly or the task was deleted.
28003 Object not found Task error with id {value} not found An error with the ID specified in the request was not found by Tasks service. The error does not exist.
28004 Object not found One or more task errors not found including task error with id {value} One or more errors were not found by Tasks service, including the error with the specified ID. The ID is incorrect or the error has been deleted.
28005 Stop tasks worker On worker shutdown all active tasks on the worker are failed all active subtasks are cancelled The task execution process was interrupted because Tasks handler was stopped. All active subtasks have been canceled. You should check the status of all Tasks service handlers. Some of the handlers became unavailable for some reason.
28006 Internal server error Failed to update task {value} status. Desired status: {value} Tasks service failed to update the specified task status. The expected status is shown.
28007 Internal server error Failed to update subtask {value} status. Desired status: {value} Tasks service failed to update the subtask status.
28008 Internal server error Failed to update task {value} progress. Desired progress: {value} Tasks service failed to update the progress of the task.
28009 Attribute is not equal Event {value} attribute is not equal {value} corresponding face attribute The event attribute ID and the corresponding Face attribute ID did not match (Linker task).
28010 Objects not found Objects for clustering not found empty set The objects specified for clustering were not found by the Tasks service.
28011 Internal server error Failed to save report to a csv-file Tasks service failed to create a CSV file for the report.
28012 Internal server error Failed to create archive from a report Tasks service failed to create the archive for the report.
28013 Bad/incomplete input data Tasks with type {value} does not support a build report You cannot create the report (a reporter task) for this type of task.
28014 Bad/incomplete input data Column {value} not allowed in report by {value} The specified column cannot be added to the report (the task of the reporter). The column is not correct.
28015 Bad/incomplete input data Tasks with status {value} does not support a build report For a task with the specified status, you cannot create a report (a reporter's task). You should wait for the task to complete to get a report.
28016 Bad/incomplete input data Clusterization task without result does not support a build report The clustering task that was not completed does not support report generation.
28017 Object not found Result of the task {value} not found The result of the specified task was not found.
28018 Object not found Task {value} does not have result yet The task has no result yet. You should wait for the task to complete.
28019 Bad/incomplete input data Task {value} with status {value} cannot be canceled A task with the specified status cannot be canceled. Depending on the status, the task may have been stopped, completed with an error, or completed.
28020 Object not found Impossible get a result of task {value} with status {value} It is unable to get the result of the Tasks service task with the specified status.
28021 Forbidden Service does not support Luna Events as source for tasks The service does not support Luna Events as a data source for tasks. You should set the value of the parameter "LUNA_EVENTS_SUPPORT = 1" in the configuration file of the Tasks service.
28022 Objects not found {value} for cross-matching not found (empty set) The specified object for cross-matching was not found.
28023 Reference uuid is missing Reference uuid is missing: {value} The object with the ID specified for the cross-matching task was not found.
28024 Reference uuid has no extracted descriptor Reference uuid has no extracted descriptor: {value} There is no extracted descriptor for the UUID specified for the cross-matching task.
28025 Task has been cancelled Task ‘{value}’ has been cancelled The task was canceled.

Sender service errors#

Error code Error Message Error Description
29001 Forbidden Cannot subscribe for events without Luna-Account-Id header set The request does not include the Luna-Account-Id header required to subscribe to the events of the Events service.
29002 Internal server error Failed to subscribe to chanel {value} Sender could not subscribe to the Reddit channel.
29003 Internal server error Failed to process input message Sender could not process the incoming image.
29004 Internal server error Failed to publish message to ws Sender could not publish a message by web socket.
29005 Service Unavailable Redis disconnected The Sender service is unavailable. Redis DB was disconnected.

Python Matcher service errors#

Error code Error Message Error Description
31000 Bad/incomplete input data Account id from query parameters does not match the one from {value} filters The Account ID specified in the query parameters does not match the Account ID from the specified filters. The data belongs to different Account IDs.
31001 Bad/incomplete input data Descriptor has the version ({value}) which does not match with version ({value}) which is supposed to use for the matching The version of the processed descriptor does not match the version, currently used for the matching
31002 Bad/incomplete input data Cross match filters presume too many received objects. Current general limit - {value} Too many objects were sent for the cross-matching task. The available limit is shown in the error.
31003 Internal server error Unknown cross matching error An unknown cross-matching error occurred.
31005 Bad/incomplete input data Matching between different versions {value} is not allowed Matching between different versions is not allowed

Liveness service errors#

Error code Error Message Error Description
32000 Internal server error Failed to predict liveness An internal server error occurs. Liveness prediction failed.
32001 A distance between face and camera is too small {value} The distance between the face and the camera is too small.
32002 Face is too close to one or more borders. {value} The face is too close to one or more borders. It is highly recommended that no part of the face extends beyond the frame and there is a distance left between the face and each of the frame sides.
32003 Face is cropped {value} One or several face sides are cropped and not inside the frame. It is highly recommended that no part of the face extends beyond the frame
32004 Face detector can’t find face on image {value} The system cannot find a face in the image. There is no face in the image or it is not distinguishable
32005 Facial area is not big enough for analysis. {value} The face is not large enough for processing. Either interpupillary distance or face size is below the required value.
32006 Facial out-of-plane rotation angle is extremely large {value} Out-of-plane rotation (face pitch and yaw) angles are greater than 20 degrees in either direction.
32007 Landmarks prediction error {value} Facial landmarks were not found
32008 Face detection error {value} An error occurred during face detection for liveness check
32009 Liveness prediction error {value} An error occurred during liveness prediction
32010 File decoding error {value} File decoding error. Check the image file.
32011 Model deserializing error {value} Model deserializing error. The model cannot be read.
32012 File encoding error {value} File decoding error. Cannot write the image
32014 Invalid fuse mode provided {value} Invalid fuse mode provided
32015 Engine or backend is not supported by the build {value} Engine or backend is not supported by the build
32017 Too many faces detected {value} Too many faces detected. The number of detected faces exceeds the maximum number of faces in the configuration. One face is set by default

Licenses service errors#

Error code Error Message Error Description
33001 License problem Failed to check HASP License feature {value} A license problem occurred. The request for the feature availability failed. Check your license. Possible reasons: the license was not applied, you use the wrong license, connection to the license server could not be established.
33002 License problem Failed to get value of HASP License feature {value} A license problem occurred. The request for the feature value failed. Check your license. Possible reasons: the license was not applied, you use the wrong license, connection to the license server could not be established.
33003 License problem No value found for required HASP License feature {value} A license problem occurred. The request for expiration date and faces limit failed. The license does not include this data. Possible reasons: the license was not applied, you use the wrong license, connection to the license server could not be established.

Handlers service errors#

Error code Error Message Error Description
34000 Object not found Handler with id {value} not found The handler with the specified ID was not found.
34001 Descriptor version {value} is not supported The descriptor with the specified version is not supported.
34002 Cannot load handler with id {value}. Handler is corrupted The system cannot load the handler with the specified ID. The handler is corrupted.
34003 Bad/incomplete input data Aggregation is not supported for raw descriptors Aggregation is not supported for raw descriptors. The error occurs when you specify aggregation and provide descriptors instead of images.
34004 Object not found Verifier with id {value} not found Verifier with the ID is not found.
34005 Bad/incomplete input data Candidates limit exceeded: {value} > {value} Candidates limit exceeded
34006 Bad/incomplete input data No candidates specified No candidates were specified
35000 Bad/incomplete input data Attributes gc is not available Attributes gc is not available
35001 Forbidden Luna Sender service is disabled Luna Sender service is disabled
35002 Handler is not supported Invalid handler with id ‘{value}’ The handler is not supported (Backport 4)
36001 Bad/incomplete input data Expected list of {value}. Got list of {value}. List id ‘{value}’ Wrong list type is provided
36002 Bad/incomplete input data Bad format basic authorization header format: Basic base64(login:password) Bad format basic authorization header,
36003 Face does not satisfy thresholds limits No faces found. Face does not satisfy threshold limits. No faces found
36004 Bad/incomplete input data Face was not linked to the person Face was not linked to the person

SDK errors#

Error code Error Message Error Description
100001 Buffer is empty The buffer is empty
100002 Buffer is null The buffer is null
100003 Buffer is full The buffer in full
100004 Descriptors are incompatible The specified descriptors are incompatible
100005 Internal error An internal error occurred
100006 Invalid buffer size Invalid buffer size
100007 Invalid descriptor Invalid descriptor
100008 Invalid descriptor batch Invalid descriptor batch
100009 Invalid detection Invalid detection
100010 Invalid image Invalid image
100011 Invalid image format Invalid image format
100012 Invalid image size Invalid image size
100013 Invalid input Invalid input
100014 Invalid landmarks 5 Invalid landmarks 5
100015 Invalid landmarks 68 Invalid landmarks 68
100016 Invalid rectangle Invalid rectangle
100017 Invalid settings provider Invalid settings provider
100018 Licensing issue Licensing issue
100019 Module is not initialized Module is not initialized
100020 Module is not ready Module is not ready
100021 FSDK image initialization error FSDK image initialization error
100022 Image loading error Image loading error
100023 Image saving error Image saving error
100024 Archive image error Archive image error
100025 Invalid detection Invalid detection
100026 Image conversion not implemented Image conversion not implemented
100027 Bad input image data pointer Bad input image data pointer
100028 Bad input image data size Bad input image data size
100029 Unsupported image format Unsupported image format
100030 Invalid image height Invalid image height
100031 Bad path for image saving / loading Bad path for image saving / loading
100032 Error at image memory opening Error at image memory opening
100033 Unsupported image type Unsupported image type
100034 Invalid image width Invalid image width
100035 Batching error Batching error
110001 Descriptor creation error Descriptor creation error
110002 Descriptors batch creation error Descriptors batch creation error
110003 Core image creation error Core image creation error
110004 Descriptor estimation error Descriptor estimation error
110005 Descriptors batch estimation error Descriptors batch estimation error
110006 Basic attributes estimation error Basic attributes estimation error
110007 Basic attributes batch estimation error Basic attributes batch estimation error
110008 AGS estimation error AGS estimation error
110009 Head pose estimation error Head pose estimation error
110011 Eyes gaze estimation error Eyes gaze estimation error
110012 Emotions estimation error Emotions estimation error
110013 Warp quality estimation error Warp quality estimation error
110014 Mouth state estimation error Mouth state estimation error
110015 Eyes estimation error Eyes estimation error
110016 Warped image creation error Warped image creation error
110017 Landmarks transformation error Landmarks transformation error
110018 Single face detection error Single face detection error
110019 Several faces detection error Several faces detection error
110020 High memory usage error High memory usage error
110021 Single human body detection error Single human body detection error
110022 Humans bodies detection error Humans bodies detection error
110023 Estimation mask error {value} Mask estimation error has occurred.
110024 Filtered aggregation error {value} Aggregation error related to the specified threshold
1100010 Estimation ethnities error {value} Ethnities estimation error
Back to top