Container Tracking API

API Entry Point https://sirius.searates.com/tracking/api
HTTP Method GET

Request Parameters

Parameter name Description
sealine Sealine ID - number from list below.
List of available sealines:
ID SeaLine Name
0 Auto Detect*
14 APL
2 ARKAS
15 CMA CGM
5 COSCO
6 EVERGREEN
4 HAMBURG SUD
7 HAPAG-LLOYD
104 HYUNDAI
10 MAERSK
1 MSC
88 ONE
17 OOCL
111 SAFMARINE
112 SEALAND
124 SINOKOR
69 TURKON
97 WAN HAI
18 YANG MING
13 ZIM

* - Auto Detect didn't work with leasing containers.

code Container number - as XXXX1234567, where XXXX is a letters.
api_key API Key - to get api key, please contact us.

Request Example and Demo

Complete request link https://sirius.searates.com/tracking/api?sealine=_SEALINE_ID_&code=XXXX1234567&api_key=_YOUR_API_KEY
Demo Containers MSCU1111222 and MSCU1111333
Demo API Key DEMO
Demo request https://sirius.searates.com/tracking/api?sealine=1&code=MSCU1111333&api_key=DEMO

Response

All possible status's
SUCCESS Container tracked.
ONLY_TEXT We tracked container, but temporary can't draw route.
DATA_NOT_FOUND We can't find container. Maybe sealine or conteiner number incorrect. Check input or try again later.
WRONG_CONTAINER_NUMBER Inputed container number is not valid.
WRONG_SEALINE_NUMBER Inputed sealine number is not valid.
WRONG_API_KEY API Key is incorrect.
EXPIRED_API_KEY API Key is expired, please contact us to extend it.
UNEXPECTED_ERROR Error. Please, contact us and explain, in what situation its happen.
All possible type's
1 transported by RAIL
2 transported by AIR
3 transported by SEA
4 transported by TRUCK
JSON Response Structure:
        
responseobject
|-------statusstring//status of this request
|-------pointsarray//places on container way
|-------|-----idnumber
|-------|-----namestring
|-------|-----latnumber
|-------|-----lngnumber
|-------|-----countrystring//contry code
|-------|-----distTonumber//distance from previous point to this
|-------|-----pathToarray//rout (poly line) from revious point to this
|-------|-----|-----(array)array//one of the routs points
|-------|-----|-----|-----[0]number//lattitude
|-------|-----|-----|-----[1]number//longtitude
|-------|-----eventsarray//array of events that heppen in this point
|-------|-----|-----datenumber//timestamp of this event
|-------|-----|-----locationnumber//id of associated(parent) point
|-------|-----|-----descriptionstring//what happen in this event
|-------|-----|-----typenumber//what type of transport provided this event
|-------|-----|-----voyagestring//voyage number, if known and type is sea
|-------|-----|-----vesselstring//vessel name, if known and type is sea
|-------sealinenumber//id of sealine, that serve this container
|-------descriptionstring//description of this container if exist
|-------trackingIDnumber//if this is a internal booking, here will be internal id
|-------containersarray//if this is a internal booking, here will array of associated containers
|-------|-------(string)string
|-------lastContainerCord string/array// (string)START/END or coord (array) [lat,lng]
Full response:
API Entry Point https://sirius.searates.com/tracking/apiv2
HTTP Method GET

Request Parameters

Parameter name Description
sealine Sealine ID or one of SCAC codes - number from list below.
List of available sealines:
ID SeaLine Name SCAC codes
0 Auto Detect* No Code
14 APL APLU
2 ARKAS ARKU
15 CMA CGM CMDU
5 COSCO COSU
6 EVERGREEN EGLV
4 HAMBURG SUD SUDU
7 HAPAG-LLOYD HLCU
104 HYUNDAI HDMU
10 MAERSK CMCU, CAMN
1 MSC MSCU
88 ONE ONEY, NYKU, NYKS, MOLU, KKLU
17 OOCL OOLU
111 SAFMARINE SAFM
112 SEALAND SEJJ, MCCQ
124 SINOKOR SKLU
69 TURKON TRKU
97 WAN HAI 22AA
18 YANG MING YMLU
13 ZIM ZIMU

* - Autodetection will try to determine the shipping line by the letter prefix of the container.

Autodetection is not relevant for leased containers.

container Container number - as XXXX1234567, where XXXX is a letters.
api_key API Key - to get api key, please contact us.

Response

All possible status's
SUCCESS Container tracked.
ONLY_TEXT We have tracked the container, but temporarily can't draw route, because shipping line is not giving right coordinates.
DATA_NOT_FOUND We can't find the container. Maybe sealine or container number is incorrect. Check the input or try again later. For leased containers make sure to indicate the right sealine.
WRONG_PARAMETERS Input parameters are not valid.
WRONG_CONTAINER_NUMBER Input container number is not valid.
WRONG_SEALINE_NUMBER Input sealine is not valid.
API_KEY_WRONG API Key is incorrect.
API_KEY_NO_ACCESS This API Key is not assigned to this product.
API_KEY_EXPIRED API Key is expired, please contact us to extend it.
REQUEST_RATE_TOO_HIGH Request rate is too high for this API key.
TOO_MANY_REQUESTS Your API key has reached its limit for this month. Please contact us to extend your subscription.
UNEXPECTED_ERROR Error. Please, contact us to understand the reason of it.
All possible type's
1 transported by RAIL
2 transported by AIR
3 transported by SEA
4 transported by TRUCK
JSON Response Structure:
        
statusstring//status of this request
pointsarray//places on container way
|-----idnumber
|-----namestring
|-----latnumber
|-----lngnumber
|-----countrystring//contry code
|-----distTonumber//distance from previous point to this
|-----pathToarray//route (poly line) from revious point to this
|-----|-----(array)array//one of the routs points
|-----|-----|-----[0]number//lattitude
|-----|-----|-----[1]number//longtitude
|-----eventsarray//array of events that heppen in this point
|-----|-----datenumber//timestamp of this event
|-----|-----locationnumber//id of associated(parent) point
|-----|-----descriptionstring//what happen in this event
|-----|-----typenumber//what type of transport provided this event
|-----|-----voyagestring//voyage number, if known and type is sea
|-----|-----vesselstring//vessel name, if known and type is sea
sealinenumber//id of sealine, that serve this container
lastContainerCord string/array// (string)START/END mean first/last known event or coord (array) [lat,lng]

BL Tracking API

API Entry Point https://sirius.searates.com/tracking/api-booking
HTTP Method GET

Request Parameters

Parameter name Description
sealine Sealine ID - number from list below.
List of available sealines:
ID SeaLine Name
0 Auto Detect*
14 APL
2 ARKAS
15 CMA CGM
5 COSCO
6 EVERGREEN
4 HAMBURG SUD
7 HAPAG-LLOYD
104 HYUNDAI
10 MAERSK
1 MSC
88 ONE
17 OOCL
111 SAFMARINE
112 SEALAND
124 SINOKOR
69 TURKON
97 WAN HAI
18 YANG MING
13 ZIM

* - Auto Detect didn't work with leasing containers.

number bill of lading number - as sealine format.
api_key API Key - to get api key, please contact us.
Complete request link https://sirius.searates.com/tracking/api-booking?sealine=_SEALINE_ID_&number=_BL_NUMBER_&api_key=_YOUR_API_KEY
JSON Response Structure:
        
responseobject
|-------bookingstring//BL number
|-------containersarray//container list
|-------|-----[0]string//container number
|-------|-----...
|-------resultsobject//result list where container number is key
|-------|-----container_numberobject//object like from container tracking api
|-------|------|-------statusstring//status of this request
|-------|------|-------pointsarray//places on container way
|-------|------|-------|-----idnumber
|-------|------|-------|-----namestring
|-------|------|-------|-----latnumber
|-------|------|-------|-----lngnumber
|-------|------|-------|-----countrystring//contry code
|-------|------|-------|-----distTonumber//distance from previous point to this
|-------|------|-------|-----pathToarray//rout (poly line) from revious point to this
|-------|------|-------|-----|-----(array)array//one of the routs points
|-------|------|-------|-----|-----|-----[0]number//lattitude
|-------|------|-------|-----|-----|-----[1]number//longtitude
|-------|------|-------|-----eventsarray//array of events that heppen in this point
|-------|------|-------|-----|-----datenumber//timestamp of this event
|-------|------|-------|-----|-----locationnumber//id of associated(parent) point
|-------|------|-------|-----|-----descriptionstring//what happen in this event
|-------|------|-------|-----|-----typenumber//what type of transport provided this event
|-------|------|-------|-----|-----voyagestring//voyage number, if known and type is sea
|-------|------|-------|-----|-----vesselstring//vessel name, if known and type is sea
|-------|------|-------sealinenumber//id of sealine, that serve this container
|-------|------|-------descriptionstring//description of this container if exist
|-------|------|-------trackingIDnumber//if this is a internal booking, here will be internal id
|-------|------|-------containersarray//if this is a internal booking, here will array of associated containers
|-------|------|-------|-------(string)string
|-------|------|-------lastContainerCord string/array// (string)START/END or coord (array) [lat,lng]
|-------|-----...//next containers