HTTP Response Codes
Qubictron uses conventional HTTP response codes to indicate the success or failure of an API request.
| code | status_code | success | description |
|---|---|---|---|
200 | OK | true | Request completed successfully. Data returned as expected. |
200 | CARRIER_INFO_NOT_PROVIDED | true | Request was successful, but the carrier has not provided any tracking information yet. |
200 | CARRIER_SHIPMENT_CANCELED | true | Request was successful. The shipment has been canceled by the carrier. |
200 | NO_CONTAINERS | true | Request was successful, but no containers were found for the given reference. |
200 | NO_EVENTS | true | Request was successful, but no tracking events are available for this shipment yet. |
400 | WRONG_PARAMETERS | false | One or more request parameters are invalid, missing, or have an unsupported value. |
400 | WRONG_CARRIER_CODE | false | The provided carrier code is invalid or does not match any known carrier. |
400 | WRONG_REFERENCE_NUMBER | false | The provided reference number has an invalid format or does not exist. |
400 | WRONG_REFERENCE_TYPE | false | The provided reference type is invalid or not recognized. |
200 | CARRIER_NOT_SUPPORTED | false | The specified carrier is not supported by this API. |
200 | CARRIER_NOT_SUPPORT_REF_TYPE | false | The carrier does not support tracking by the provided reference type. |
200 | CARRIER_TEMPORARILY_DISABLED | false | The carrier integration is temporarily disabled. Please try again later. |
200 | CARRIER_UNDER_MAINTENANCE | false | The carrier's system is currently under maintenance. Please try again later. |
200 | CARRIER_NO_RESPONSE | false | The carrier did not respond within the expected time. Please try again later. |
200 | AUTO_CANT_DETECT_CARRIER | false | Could not automatically detect the carrier from the provided reference number. |
200 | AUTO_CANT_FIND_INFO | false | Carrier was detected automatically, but no tracking information could be retrieved. |
401 | INVALID_API_KEY | false | The provided API key is missing, invalid. |
403 | API_KEY_ACCESS_DENIED | false | The API key does not have permission to access this resource. |
403 | API_KEY_EXPIRED | false | The API key has expired. Please renew or replace it. |
429 | API_KEY_QUOTA_EXCEEDED | false | The API key has exhausted its total request quota for the current billing period. |
429 | API_KEY_RATE_LIMIT_EXCEEDED | false | The API key has exceeded the allowed request rate. Please slow down and retry. |
500 | UNEXPECTED_ERROR | false | An unexpected internal server error occurred. Please try again or contact support. |