• Version 01
  • Version 02
  • Version 03

API Entry Point

https://sirius.searates.com/tracking/api

Method - GET

Request Parameters

Parameter
Description
sealine

Sealine ID - number from list below:

ID
Sealine Name
0
Auto Detect*
1
MSC
2
ARKAS
4
HAMBURG SUD
5
COSCO
6
EVERGREEN
7
HAPAG-LLOYD
10
MAERSK
13
ZIM
14
APL
15
CMA CGM
17
OOCL
18
YANG MING
69
TURKON
88
ONE
97
WAN HAI
104
HYUNDAI
111
SAFMARINE
112
SEALAND
124
SINOKOR

* - Auto Detect didn't work with leasing containers

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

Request Parameter and Demonstration

Name
Description
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

Response

Name
Description
All possible statuses
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 container number is incorrect. Check input or try again later
WRONG_CONTAINER_NUMBER
Inputed container number is not valid
WRONG_SEALINE_NUMBER
Inputted 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 types
1
Transported by RAIL
2
Transported by AIR
3
Transported by SEA
4
Transported by TRUCK

JSON Response Structure

response object
|-------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]
                

API Entry Point

https://sirius.searates.com/tracking/apiv2

Method - GET

Request Parameters

Parameter
Description
sealine

Sealine ID or one of SCAC codes - number from list below:

ID
Sealine Name
SCAC codes
0
Auto Detect*
AUTO
1
MSC
MSCU
2
ARKAS
ARKU
4
HAMBURG SUD
SUDU
5
COSCO
COSU
6
EVERGREEN
EGLV
7
HAPAG-LLOYD
HLCU
10
MAERSK
CMCU, CAMN, MAEU
13
ZIM
ZIMU
14
APL
APLU
15
CMA CGM
CMDU
17
OOCL
OOLU
18
YANG MING
YMLU
69
TURKON
TRKU
88
ONE
ONEY, NYKU, NYKS, MOLU, KKLU
97
WAN HAI
22AA
104
HYUNDAI
HDMU
111
SAFMARINE
SAFM
112
SEALAND
SAFM
124
SINOKOR
SKLU

* - Auto Detect didn't work with leasing containers

Auto detection is not relevant for leased containers

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

Response

Name
Description
All possible statuses
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
Inputted sealine number is not valid
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 types
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]
                

Base URL: https://tracking.searates.com

Bill of Lading and Booking

Receive info by Bill of Lading or Booking

URL of request (method GET) - /reference

Request Params

Parameter
Type
Description
type
String

Type of document. It takes the value:

BL = Bill of Lading,

BK = Booking

number
String
Document number
sealine
String
Standard Carrier Alpha Code (SCAC). See supported table for a list of supported shipping lines
api_key
String
Your API key
force_update
Boolean
Optional parameter.​ Can be true or false. It is false by default. If true, the data will be requested from the carrier (this may affect the speed of the request). If false, they will be read from the cache (the request will be executed quicker)

Response Parameters Description

Parameter
Type
Description
status
String
Request Status: success - upon successful completion of the request; error - when an error occurs
message
String
Request status description. See "Request Statuses" table
data
Object
Data on request. See "Response Parameter Description - data" table

Request Statuses Description

Request Status
Request Status Description
Description
success
OK
Request completed successfully. There is information on containers and events
error
SEALINE_NO_RESPONSE
An error occurred while executing the request. The line is not responding
success
SEALINE_HASNT_PROVIDE_INFO
Request completed successfully. The line replied that nothing was found for this request
success
NO_CONTAINERS
Request completed successfully. The line did not provide container information
success
NO_EVENTS
Request completed successfully. The line provided information on containers, but did not provide information on events
error
WRONG_PARAMETERS
Your request is missing required parameters
error
API_KEY_WRONG
Invalid API key
error
API_KEY_ACCESS_DENIED
This API key does not have access to the product
error
API_KEY_EXPIRED
This API key has expired
error
API_KEY_LIMIT_REACHED
This API key has exceeded the limit for the number of requests
error
API_KEY_RATE_LIMIT
This API key has exceeded the allowed request frequency limit
error
WRONG_TYPE
The specified document type is invalid. See the description of the type parameter in the Query Parameters table
error
WRONG_NUMBER
Invalid bill of lading or booking number indicated
error
WRONG_SEALINE
Invalid carrier alpha code (SCAC) specified
error
SEALINE_NOT_SUPPORTED
No support for this carrier
error
UNEXPECTED_ERROR
Unexpected error

Response Parameter Description - data

Parameter
Type
Description
locations
Array
An array with all locations. See Locations Descriptions table
route
Object
Information on the route. See Route Description table
vessels
Array
Array with ships. See Vessels Description table
containers
Array
Array with containers. See Containers Description table

Locations Description

Each element of the locations array is an object that has a structure

Parameter
Type
Description
id
Integer
Unique identifier
name
String
The name of the location. It can be a city or any other settlement
state
String | null
First level administrative unit (district, state, province, region, county, department, ..)
country
String
Country name.
country_code
String
Country code (2 characters)
locode
String | Null
UN/LOCODE
lat
Float | Null
Latitude
lng
Float | Null
Longitude

Route Description

Parameter
Type
Description
prepol
Object
Place of dispatch. See "Prepol Description" table
pol
Object
Port of loading. See "Pol Description" table
pod
Object
Port of discharge. See "Pod Description" table
postpod
Object
Destination. See "Postpod Description" table

Prepol Description

Parameter
Type
Description
location
Integer | Null
Unique identifier (id) from the locations array.
date
String | null
Arrival date.
actual
true | false | null
If the date is true - it was confirmed by carrier, if false - it is estimated, if null - not defined yet

Pol Description

Parameter
Type
Description
location
Integer | Null
Unique identifier (id) from the locations array
date
String | null
Arrival date at port of loading
actual
true | false | null
If the date is true - it was confirmed by a carrier, if false - it is estimated, if null - not defined yet

Pod Description

Parameter
Type
Description
location
Integer | Null
Unique identifier (id) from the locations array
date
String | null
Arrival date at port of discharge
actual
true | false | null
If the date is true - it was confirmed by carrier, if false - it is estimated, if null - not defined yet

Postpod Description

Parameter
Type
Description
location
Integer | Null
Unique identifier (id) from the locations array
date
String | null
Arrival date at port of discharge
actual
true | false | null
If the date is true - it was confirmed by carrier, if false - it is estimated, if null - not defined yet

Vessels Description

Each element of the vessels array is an object that has a structure:

Parameter
Type
Description
id
Integer
Unique identificator
name
String
Vessel Name
imo
Integer | null
Unique identifier of the vessel
call_sign
String | null
Call sign of the ship
mmsi
Integer | null
Maritime Mobile Service Identity
flag
String | null
Country Code (2 characters)

Сontainers Description

Each element of the containers array is an object that has a structure:

Parameter
Type
Description
number
String
Container number
iso_code
String | null
Container ISO code
events
Array
Array with events. Description of events

Events Description

Each element of the events array is an object that has a structure:

Parameter
Type
Description
location
Integer | null
Unique identifier (id) from the locations array
description
String
Event Description
status
String
3 character event code. See "Events Codes" table
date
String
Event date
actual
true | false | null
If the date is true - it was confirmed by a carrier, if false - it is estimated, if null - not defined yet
type
String
Description of the event location. Valid Values: sea - for events related to the sea; land - for land related events
vessel
Integer | null
Unique identifier (id) from vessels array
voyage
String | null
Sea voyage identifier

Events Codes

Event Description
Event Code
Unknown
UNK
Land transshipment
LTS
Barge transshipment
BTS
Container empty to shipper
CEP
Container pickup at shipper
CPS
Container arrival at first POL (Gate in)
CGI
Container loaded at first POL
CLL
Vessel departure from first POL
VDL
Vessel arrival at T/S port
VAT
Container discharge at T/S port
CDT
Transshipment Delay
TSD
Container loaded at T/S port
CLT
Vessel departure from T/S
VDT
Vessel arrival at final POD
VAD
Container discharge at final POD
CDD
Container departure from final POD (Gate out)
CGO
Container delivery to consignee
CDC
Container empty return to depot
CER

Request Example

GET /https://tracking.searates.com/reference?type=BL&number=SII166268&sealine=maeu&api_key=_your_api_key_

Response Example

{
    "status": "success",
    "message": "OK",
    "data": {
        "locations": [
            {
                "id": 1,
                "name": "Long Beach",
                "state": "California",
                "country": "United States",
                "country_code": "US",
                "locode": "USLGB",
                "lat": 33.76696,
                "lng": -118.18923
            },
            {
                "id": 2,
                "name": "Haiphong",
                "state": "Thanh Pho Hai Phong",
                "country": "Vietnam",
                "country_code": "VN",
                "locode": "VNHPH",
                "lat": 20.86481,
                "lng": 106.68345
            },
            {
                "id": 3,
                "name": "Yantian",
                "state": "Guangdong Sheng",
                "country": "China",
                "country_code": "CN",
                "locode": "CNYTN",
                "lat": 22.58333,
                "lng": 114.26667
            },
            {
                "id": 4,
                "name": "Hong Kong",
                "state": "Central and Western District",
                "country": "Hong Kong",
                "country_code": "HK",
                "locode": "HKHKG",
                "lat": 22.27832,
                "lng": 114.17469
            }
        ],
        "route": {
            "prepol": {
                "location": 1,
                "date": "2021-01-13 01:57:00",
                "actual": true
            },
            "pol": {
                "location": 1,
                "date": "2021-01-14 23:57:00",
                "actual": true
            },
            "pod": {
                "location": 2,
                "date": "2021-03-15 16:00:00",
                "actual": false
            },
            "postpod": {
                "location": 2,
                "date": null,
                "actual": null
            }
        },
        "vessels": [
            {
                "id": 1,
                "name": "MAERSK ENSHI",
                "imo": 9502946,
                "call_sign": "3FIL",
                "mmsi": 355288000,
                "flag": "PA"
            },
            {
                "id": 2,
                "name": "MAERSK STRALSUND",
                "imo": 9303522,
                "call_sign": "9V5634",
                "mmsi": 563032800,
                "flag": "SG"
            },
            {
                "id": 3,
                "name": "HANSA COLOMBO",
                "imo": 9357781,
                "call_sign": "V7MO8",
                "mmsi": 538090571,
                "flag": "MH"
            }
        ],
        "containers": [
            {
                "number": "BEAU5097502",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-13 01:57:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-14 23:57:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 01:14:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-06 14:05:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:53:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 21:25:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            },
            {
                "number": "MRKU2705499",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-12 15:25:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-15 15:13:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 20:48:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-05 21:38:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:44:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 20:45:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            },
            {
                "number": "MSKU0335951",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-12 01:36:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-14 22:40:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 01:22:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-06 13:42:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:40:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 21:30:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            },
            {
                "number": "MSKU0513082",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-12 10:18:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-14 20:20:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 01:22:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-06 13:38:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:48:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 21:35:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            },
            {
                "number": "PONU7497023",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-12 02:23:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-15 01:12:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 01:05:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-06 13:34:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:34:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 21:45:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            },
            {
                "number": "TCNU4042592",
                "iso_code": "42G0",
                "events": [
                    {
                        "location": 1,
                        "description": "Gate out Empty",
                        "status": "CEP",
                        "date": "2021-01-12 13:03:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Gate in",
                        "status": "CGI",
                        "date": "2021-01-14 18:25:00",
                        "actual": true,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    },
                    {
                        "location": 1,
                        "description": "Load",
                        "status": "CLL",
                        "date": "2021-01-25 01:26:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-06 14:05:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 1,
                        "voyage": "101S"
                    },
                    {
                        "location": 3,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-08 23:42:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Discharge",
                        "status": "CDT",
                        "date": "2021-03-09 21:10:00",
                        "actual": true,
                        "type": "sea",
                        "vessel": 2,
                        "voyage": "109S"
                    },
                    {
                        "location": 4,
                        "description": "Load",
                        "status": "CLT",
                        "date": "2021-03-13 14:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Discharge",
                        "status": "CDD",
                        "date": "2021-03-15 16:00:00",
                        "actual": false,
                        "type": "sea",
                        "vessel": 3,
                        "voyage": "110S"
                    },
                    {
                        "location": 2,
                        "description": "Gate out",
                        "status": "CGO",
                        "date": "2021-03-15 16:00:09",
                        "actual": false,
                        "type": "land",
                        "vessel": null,
                        "voyage": null
                    }
                ]
            }
        ]
    }
}
                

Containers

Getting Container Information

Request URL (GET method) - /container

Request Parameters

Parameter
Type
Description
number
String
Container number
sealine
String
Standard Carrier Alpha Code (SCAC). See supported table for a list of supported shipping lines
api_key
String
Your API key
force_update
Boolean
Optional parameter. ​It can be true or false. It is false by default. If true, the data will be requested from the carrier (this may affect the speed of the request); if false, they will be read from the cache (the request will be executed quicker)

Request Example

GET /https://tracking.searates.com/container?number=TGBU6795701&sealine=maeu&api_key=_your_api_key_

The structure of the response is completely identical to the structure of the answer by bills of lading (BK), except that in the data parameter containers is renamed to container and the type is changed from Array to Object.

Response Example

{
    "status": "success",
    "message": "OK",
    "data": {
        "locations": [
            {
                "id": 1,
                "name": "Salalah",
                "state": "Muhafazat Zufar",
                "country": "Oman",
                "country_code": "OM",
                "locode": "OMSLL",
                "lat": 17.01505,
                "lng": 54.09237
            },
            {
                "id": 2,
                "name": "Houston",
                "state": "Texas",
                "country": "United States",
                "country_code": "US",
                "locode": "USHOU",
                "lat": 29.76328,
                "lng": -95.36327
            }
        ],
        "route": {
            "prepol": {
                "location": 1,
                "date": "2021-02-07 11:03:00",
                "actual": true
            },
            "pol": {
                "location": 1,
                "date": "2021-02-09 13:56:00",
                "actual": true
            },
            "pod": {
                "location": 2,
                "date": "2021-03-20 08:00:00",
                "actual": false
            },
            "postpod": {
                "location": 2,
                "date": null,
                "actual": null
            }
        },
        "vessels": [
            {
                "id": 1,
                "name": "MAERSK ATLANTA",
                "imo": 9348649,
                "call_sign": "WNTL",
                "mmsi": 338078000,
                "flag": "US"
            }
        ],
        "container": {
            "number": "TGBU6795701",
            "iso_code": "42G0",
            "events": [
                {
                    "location": 1,
                    "description": "Gate out Empty",
                    "status": "CEP",
                    "date": "2021-02-07 11:03:00",
                    "actual": true,
                    "type": "land",
                    "vessel": null,
                    "voyage": null
                },
                {
                    "location": 1,
                    "description": "Gate in",
                    "status": "CGI",
                    "date": "2021-02-09 13:56:00",
                    "actual": true,
                    "type": "land",
                    "vessel": null,
                    "voyage": null
                },
                {
                    "location": 1,
                    "description": "Load",
                    "status": "CLL",
                    "date": "2021-02-18 07:33:00",
                    "actual": true,
                    "type": "sea",
                    "vessel": 1,
                    "voyage": "105W"
                },
                {
                    "location": 2,
                    "description": "Discharge",
                    "status": "CDD",
                    "date": "2021-03-20 08:00:00",
                    "actual": false,
                    "type": "sea",
                    "vessel": 1,
                    "voyage": "105W"
                },
                {
                    "location": 2,
                    "description": "Gate out",
                    "status": "CGO",
                    "date": "2021-03-20 08:00:05",
                    "actual": false,
                    "type": "land",
                    "vessel": null,
                    "voyage": null
                }
            ]
        }
    }
}
                

Supported Shipping Lines List

Routes

Route Tracking

To get route, you need to track it at first:

End Point: GET https://tracking.searates.com/route

Request Parameters

Name
Description
type
CT, BL, BK
number
Number of container booking or B/L
sealine
SCAC code of shipping line
api_key
your API key

Response Example

Parameter
Description
type
CT, BL, BK
number
Number of container booking or B/L
sealine
SCAC code of shipping line
api_key
your API key
{
    "status": "success",
    "message": "OK",
    "data": {
        "route" : [
            {
                "path": [...], // 2247 items,
                "type": "LAND"
            },
            {
                "path": [
                    [
                        39.51394,
                        -121.50776
                    ],
                    [
                        37.55176504165017,
                        -122.54747555223851
                    ],
                    [
                        37.8227,
                        -121.27661
                    ]
                ],
                "type": "SEA",
            }
        ],
        "pin": [
            40.83242,
            -115.76312
        ]
    }
}
                
Parameter
Type
Description
status
Srting
Can be: WRONG_PARAMETERS, WRONG_TYPE, WRONG_SEALINE, SEALINE_NOT_SUPPORTED, DONT_TRACKED
data
Object

Response Parameter Description - data

Parameter
Type
Description
route
Object
Array of objects
path
float
Array of float array [latitude, longitude]. It's a full route
type
String
LAND or SEA
pin
float | null
Array of [latitude, longitude] or null. Current pin position

If NOT_TRACKED you need to track it at first.

Bill of Lading Tracking API

API Entry Point

https://sirius.searates.com/tracking/api-booking

Method - GET

Request Parameters

Parameter
Description
sealine

Sealine ID - number from list below:

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

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

Response

Name
Description
All possible statuses
SUCCESS
BL tracked
ONLY_TEXT
We tracked container, but temporary can't draw route
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