Container Tracking API

V1 (Deprecated)

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

Запросить параметры

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

[{"id":14,"name":"APL","scac":"APLU"},{"id":2,"name":"ARKAS","scac":"ARKU"},{"id":15,"name":"CMA CGM","scac":"CMDU"},{"id":5,"name":"COSCO","scac":"COSU"},{"id":6,"name":"EVERGREEN","scac":"EGLV"},{"id":4,"name":"HAMBURG SUD","scac":"SUDU"},{"id":7,"name":"HAPAG-LLOYD","scac":"HLCU"},{"id":104,"name":"HYUNDAI","scac":"HDMU"},{"id":10,"name":"MAERSK","scac":"CMCU, CAMN, MAEU"},{"id":1,"name":"MSC","scac":"MSCU"},{"id":88,"name":"ONE","scac":"ONEY, NYKU, NYKS, MOLU, KKLU"},{"id":17,"name":"OOCL","scac":"OOLU"},{"id":111,"name":"SAFMARINE","scac":"SAFM"},{"id":112,"name":"SEALAND","scac":"SEJJ, MCCQ"},{"id":124,"name":"SINOKOR","scac":"SKLU"},{"id":69,"name":"TURKON","scac":"TRKU"},{"id":97,"name":"WAN HAI","scac":"22AA"},{"id":18,"name":"YANG MING","scac":"YMLU"},{"id":13,"name":"ZIM","scac":"ZIMU"}]

* - 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.

Запросить пример и демонстрацию

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`

Ответ

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:

V2 (Actual)

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

Запросить параметры

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*	AUTO
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, MAEU
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.

Ответ

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
        |-----code5string//UNLOCODE of Port
        |-----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]

Отслеживание Коносамента API

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

Запросить параметры

Parameter name Description

sealine

Sealine ID - number from list below.

List of available sealines:

ID	SeaLine Name	SCAC codes
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, MAEU
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

[{"id":14,"name":"APL","scac":"APLU"},{"id":2,"name":"ARKAS","scac":"ARKU"},{"id":15,"name":"CMA CGM","scac":"CMDU"},{"id":5,"name":"COSCO","scac":"COSU"},{"id":6,"name":"EVERGREEN","scac":"EGLV"},{"id":4,"name":"HAMBURG SUD","scac":"SUDU"},{"id":7,"name":"HAPAG-LLOYD","scac":"HLCU"},{"id":104,"name":"HYUNDAI","scac":"HDMU"},{"id":10,"name":"MAERSK","scac":"CMCU, CAMN, MAEU"},{"id":1,"name":"MSC","scac":"MSCU"},{"id":88,"name":"ONE","scac":"ONEY, NYKU, NYKS, MOLU, KKLU"},{"id":17,"name":"OOCL","scac":"OOLU"},{"id":111,"name":"SAFMARINE","scac":"SAFM"},{"id":112,"name":"SEALAND","scac":"SEJJ, MCCQ"},{"id":124,"name":"SINOKOR","scac":"SKLU"},{"id":69,"name":"TURKON","scac":"TRKU"},{"id":97,"name":"WAN HAI","scac":"22AA"},{"id":18,"name":"YANG MING","scac":"YMLU"},{"id":13,"name":"ZIM","scac":"ZIMU"}]

* - 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.

define_ports Define Ports - set true to get additional details

Complete request link https://sirius.searates.com/tracking/api-booking?sealine=_SEALINE_ID_&number=_BL_NUMBER_&api_key=_YOUR_API_KEY

Ответ

All possible status's

`SUCCESS`	BL tracked.
`API_KEY_WRONG`	API Key is incorrect.
`EXPIRED_API_KEY`	API Key is expired, please contact us to extend it.
`NOT_VALID_LINE`	Incorrect line
`NO_RESPONSE_FROM_CARRIER`	No response from carrier
`ERROR`	contact us

JSON Response Structure:

        statusstring//status of this request
        resultarray
        |-----bl_numberstring
        |-----originstring
        |-----destinationstring
        containersarray//containers list
        |-----[0]
        |-----|--numberstring//container number
        |-----|--typestring//container type
        |-----|--eventsarray//array of container events
        |-----|-----[0]
        |-----|-----|--nonumber
        |-----|-----|--statusstring//event status
        |-----|-----|--locationstring//name of location
        |-----|-----|--datestring//date of event in (dd.mm.yyyy hh:mm) format
        |-----|-----|--vesselstring//vessel name, if exist
        |-----|-----|--voyagestring//voyage number, if exist

Logistics Explorer

Load Calculator

Container Tracking

Distances & Time

Route Planner

Ship Schedules

Smart Documents BETA

Информация

Размеры

Container Tracking API

V1 (Deprecated)

Запросить параметры

Запросить пример и демонстрацию

Ответ

V2 (Actual)

Запросить параметры

Ответ

Отслеживание Коносамента API

Запросить параметры

Ответ