Troubleshooting

The Data API returns an HTTP response code per request. In the event of a validation error, an application specific code is returned in the meta packet.

The following HTTP response codes may be sent by the application.

Response CodeTitleMessage for developers
200
OK A successful request
400
Bad Request Most likely due to missing or erroneous request parameters
403
Forbidden Typically for incorrect authentication details. Could also mean attempting to access over HTTP instead of HTTPS
405
Method Not Allowed Invalid request method
409
Conflict Request could not be completed due to a conflict with current state of the resource
410
Gone The URL requested is no longer available
429
Too Many Requests Too many requests has been received. See rate limiting
500
Internal Server Error Oops, a server error

A successful request (200 OK) may still fail for reasons such as request data validation. The table below describes the different application error codes that could be returned in the meta response packet.

ErrorMessage for usersMessage for developers
Error code: 10000
Response code: 500
An error has occurred An internal error has occurred. It has been logged and Learnosity is probably already looking into it.
Error code: 20000
Response code: 400
Missing mandatory parameter(s) Specify the required parameters.
Error code: 20001
Response code: 400
Invalid parameter length Ensure your request parameters match the expected length.
Error code: 20002
Response code: 400
Too many parameters passed Ensure your request parameters match the expected length. If specifying a search filter with many values, you may need to batch the values into separate requests and union the separate results.
Error code: 20003
Response code: 400
Invalid parameter type Ensure your request parameters match the expected type.
Error code: 20004
Response code: 400
Invalid parameter value Ensure your request parameters match one of the supported values.
Error code: 20009
Response code: 400
JSON failed to validate against schema Check the response message for details on the specific validation errors in the request.
Error code: 20010
Response code: 400
XML failed to validate against schema Check the response message for details on the specific validation errors in the request.
Error code: 20011
Response code: 409
Conflict Check the error message for details on why the operation could not be completed.
Error code: 20012
Response code: 404
Not Found Check the endpoint URL.
Error code: 20013
Response code: 400
Item not found in database Check the response message for details on which Items couldn't be found. Verify those Items exist in the desired Item bank and retry your request.
Error code: 20014
Response code: 400
Tag not found Verify the specified Tag exists in the desired Item bank.
Error code: 20015
Response code: 400
Tag type not found Verify the specified Tag type exists in the desired Item bank.
Error code: 20016
Response code: 400
Session not found Verify a Session exists with the specified session_id.
Error code: 20017
Response code: 400
Dynamic content data missing or incomplete Check the format of dynamic content data provided in the request.
Error code: 20018
Response code: 500
An adaptive assessment error has occurred. An internal error has occurred. It has been logged and Learnosity is probably already looking into it.
Error code: 30000
Response code: 400
Duplicate entry in database Ensure the identifiers in your request are unique.
Error code: 30001
Response code: 400
Database value missing (typically foreign key constraint) Check the response message for details on which records couldn't be found. Verify those records exist in the desired Item bank and retry your request.
Error code: 30003
Response code: 400
Items in activities need to be unique Verify the specified Items are unique and retry the request.
Error code: 40000
Response code: 400
Access denied Verify your consumer credentials and endpoint URL are correct.
Error code: 40001
Response code: 405
Method not allowed Verify your consumer credentials and endpoint URL are correct.
Error code: 40002
Response code: 403
Consumer is not associated with an organisation An internal error has occurred. It has been logged and Learnosity is probably already looking into it.
Error code: 40003
Response code: 403
Consumer does not have sufficient access rights to current organisation (typically attempting write operation with read only access) Verify you have specified the correct consumer credentials and org_id in your request.
Error code: 41006
Response code: 403
Expired parameter must be a GMT date of format YYYYMMDD-HHMM Verify the expires parameter used to sign the request is in YYYYMMDD-HHMM format.
Error code: 41007
Response code: 403
Request after the expire timestamp Resign the request with a new expires parameter and retry.
Error code: 41000
Response code: 400
Missing security parameters Verify you have specified your consumer credentials according to the Data API security pattern.
Error code: 41001
Response code: 403
Invalid parameter length Verify the provided security signature is a valid md5 hash.
Error code: 41002
Response code: 403
Not a valid consumer Verify the provided consumer key is correct.
Error code: 41003
Response code: 403
Signatures do not match Verify the provided security signature was generated correctly.
Error code: 41004
Response code: 403
Timestamp out of valid range Resign the request with a new signature and retry.
Error code: 41005
Response code: 403
Invalid domain Verify the domain used to sign the request is correct. In the case of Data API requests sent from the browser, the domain used to the sign the request must match the browser's domain when it sends the request.
Error code: 42000
Too many requests Reduce the number of requests. deeplink: Rate limiting url: /analytics/data/knowledgebase/ratelimiting response_code: 429
Error code: 42001
Response code: 410
The endpoint is no longer available Browse our other endpoints for a suitable alternative.
Error code: 43000
Response code: 400
Requested version is lower than consumer minimum Specify a newer version in your endpoint URL.
Error code: 44000
Response code: 400
Unrecognised dataset_type Verify the dataset_type specified in your request.
Error code: 50000
Response code: 400
Report Dataset is missing some required data Upload the required dataset files before attempting to commence the dataset generation. See our implementation guide for details.
Error code: 50100
Response code: 500
An error occurred An internal error has occurred. It has been logged and Learnosity is probably already looking into it.