Skip to content
Documentation sections

Error codes

The Container Tracking API reports two kinds of failure. A 200 response with an error message means the API reached the shipping line, but the shipping line returned no tracking data. A 400, 405 or 500 response means the API could not query the shipping line at all.

200 responses without tracking data

A 200 response with one of these messages means the shipping line was detected and answered, but its answer contains no tracking data.

HTTP statusMessageMeaning
200SEALINE_HASNT_PROVIDE_INFOThe request completed. The shipping line replied that nothing was found for this shipment.
200SEALINE_CANCELED_SHIPMENTThe request completed. The shipment is cancelled.

SEALINE_HASNT_PROVIDE_INFO is often temporary: retry the request later, most of these shipments return results once the shipping line publishes their data.

400, 405 and 500 responses

A 400, 405 or 500 response means the API could not query the information from the shipping line. A request ending in one of these errors is not charged.

HTTP statusMessageMeaning
400BAD_REQUESTRequired parameters are missing from the request.
400Param: shipmentNumber cannot be null or emptyThe shipmentNumber parameter is missing or empty.
400WRONG_NUMBERThe container, bill of lading or booking number is invalid.
400WRONG_SEALINEThe carrier SCAC code is invalid.
400WRONG_TYPEThe shipment type is invalid.
400Cannot convert value: {value} into request type: BooleanA boolean parameter, such as route or ais, received a value other than true or false.
400SEALINE_NO_RESPONSEAn error occurred while executing the request: the shipping line is not responding.
400SEALINE_TEMPORARY_DISABLEDThe shipping line is temporarily disabled. Try again later.
400AUTO_CANT_DETECT_SEALINEThe shipping line could not be autodetected. Set the sealine parameter.
400AUTO_CANT_DETECT_TYPEThe shipment type could not be autodetected. Set the shipmentType parameter.
400AUTO_CANT_FIND_INFONo information could be autodetected for this number. Set both the sealine and shipmentType parameters.
400SEALINE_NOT_SUPPORTEDThe SCAC code is not supported. GET /sealines lists the supported shipping lines and their SCAC codes.
400TYPE_NOT_SUPPORTED_FOR_SEALINEThe shipping line does not support this shipment type. GET /sealines lists the types each line supports.
400WRONG_PARAMETERSThe request parameters are invalid.
400SEALINE_UNDER_MAINTENANCEThe shipping line is under maintenance. Try again later.
405Method POST is not allowedThe endpoint was called with an HTTP method it does not accept.
500An unexpected error has occurredAn unexpected error occurred on the server side.

React to an error

When a request fails, retry it, and set the optional parameters you know — the sealine SCAC code above all, then the shipmentType. The endpoint GET /sealines returns the supported shipping lines, their SCAC codes and the shipment types each one accepts.

To test how an integration handles these errors, the free test shipments ZZZZ0000001 (AUTO_CANT_DETECT_SEALINE) and ZZZZ0000002 (SEALINE_HASNT_PROVIDE_INFO) return them on every request. The Sandbox and test shipments page lists every test shipment.