- 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]
Full Response Example
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
Autodetect not supported
Autodetect not supported
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
SEALINE_CANCELED_SHIPMENT
Request completed successfully. Shipment cancelled
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
This is the first received event from the shipping line in the first 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
date of the first received event in the final/last port of discharge. As per rule this is the date of arrival.
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
date of the first received event in the last destination point/location.
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
For auto-detection of the sealine, set the parameter as - AUTO
For auto-detection of the sealine, set the parameter as - AUTO
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.
AIS Data
Now Route Tracking API supports AIS data across the vessels the containers are being shipped at.
In order to receive this data, you need to pass the ‘ais’ parameter in the request which should be equal to ‘true’. Below is the example:
https://tracking.searates.com/route?type=CT&number=CMAU1744423&sealine=cmdu&ais=true&api_key=_your_api_key_
{
"ais": {
"status": "OK",
"data": {
"last_event": {
"description": "Export Loaded on Vessel",
"date": "2021-10-22 00:00:00",
"voyage": "141E"
},
"discharge_port": {
"name": "Odessa",
"country_code": "UA",
"code": "ODS",
"date": "2021-11-22 00:00:00",
"date_label": "ETA"
},
"vessel": {
"name": "SAN VICENTE",
"imo": 9699206,
"call_sign": "9V2089",
"mmsi": 563052800,
"flag": "SG"
},
"last_vessel_position": {
"lat": 40.66469,
"lng": -74.14503,
"updated_at": "2021-10-22 13:51:02"
},
"departure_port": {
"country_code": "US",
"code": "NYC",
"date": "2021-10-21 10:19:00",
"date_label": "ATA"
},
"arrival_port": {
"country_code": "US",
"code": "BAL",
"date": "2021-10-23 03:00:00",
"date_label": "ETA"
},
"updated_at": "2021-10-22 13:54:06"
}
}Parameter
Type
Description
status
String
‘Status’ field can take the next meanings:
- OK (container is on board and AIS data is available)
- NOT_ON_BOARD (the container is not on the board; for instance, transported by another mode of transport, or the shipping process for it has not yet begun / has been completed)
- NO_AIS_DATA (we know that the container is being transported by ship, barge or feeder and there is currently no AIS data for it)
- OK (container is on board and AIS data is available)
- NOT_ON_BOARD (the container is not on the board; for instance, transported by another mode of transport, or the shipping process for it has not yet begun / has been completed)
- NO_AIS_DATA (we know that the container is being transported by ship, barge or feeder and there is currently no AIS data for it)
data
Object | null
Description of the ‘data’ field:
- last_event (the latest event provided by the shipping line – description, date and voyage)
- discharge_port - data of the final port of discharge received from the shipping line: country_code - the country code of the arrival port, code – port code, date – arrival date, date_label – shows if the event has already happened, planned (ETA), actual (ATA) or null, if the shipping line didn’t provide the arrival date.
- vessel (vessel data – name, IMO, Call Sign, MMSI, flag)
- last_vessel_position (AIS data of the vessel position: lat – latitude, lng – longitude)
- updated_at – (time when the AIS data was received based on Universal Time (UTC))
- departure_port (data on Port of Loading (POL): country_code – the country code of the departure port, code – port code, date – departure date, date_label – shows if the event is planned (ETD) or actual (ATD); note: this is not necessarily related to the first POL for the requested shipment, and it doesn’t mean that any changes will occur to the requested container/containers; it may just be an intermediate port where the vessel enters)
- arrival_port (data on Port of Discharge (POD): country_code – the country code of the arrival port, code – port code, date – arrival date, date_label – shows if the event is planned (ETA) or actual (ATA); note: this is not necessarily related to the last POD for the requested shipment, and it doesn’t mean that any changes will occur to the requested container/containers; it may just be an intermediate port where the vessel enters)
- updated_at – shows the last time the AIS data was requested based on UTC (frequency of updates: 1 time / hour)
- last_event (the latest event provided by the shipping line – description, date and voyage)
- discharge_port - data of the final port of discharge received from the shipping line: country_code - the country code of the arrival port, code – port code, date – arrival date, date_label – shows if the event has already happened, planned (ETA), actual (ATA) or null, if the shipping line didn’t provide the arrival date.
- vessel (vessel data – name, IMO, Call Sign, MMSI, flag)
- last_vessel_position (AIS data of the vessel position: lat – latitude, lng – longitude)
- updated_at – (time when the AIS data was received based on Universal Time (UTC))
- departure_port (data on Port of Loading (POL): country_code – the country code of the departure port, code – port code, date – departure date, date_label – shows if the event is planned (ETD) or actual (ATD); note: this is not necessarily related to the first POL for the requested shipment, and it doesn’t mean that any changes will occur to the requested container/containers; it may just be an intermediate port where the vessel enters)
- arrival_port (data on Port of Discharge (POD): country_code – the country code of the arrival port, code – port code, date – arrival date, date_label – shows if the event is planned (ETA) or actual (ATA); note: this is not necessarily related to the last POD for the requested shipment, and it doesn’t mean that any changes will occur to the requested container/containers; it may just be an intermediate port where the vessel enters)
- updated_at – shows the last time the AIS data was requested based on UTC (frequency of updates: 1 time / hour)
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
