Entry point: 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. The default is false. 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 quickly

Request example

GET /​reference?type=BL&number=SII130613&sealine=maeu&api_key=XXXX-XXXX-XXXX-XXXX

Description of response parameters

Параметр

Тип

Описание

status

String

Request Status: success - upon successful completion of the request; error - when an error occurs

message

String

Request status description: See table for request statuses.

data

Object

Data on request. See table Description of response parameter - data

Description of request statuses

Request Status

Request Status Description

Description

success

ОК

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 table Description locations

route

Object

Information on the route. See table Description route

vessels

Array

Array with ships. See table Description Vessels

containers

Array

Array with containers. See table Description containers

Description of locations

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

Parameter

Type

Description

id

Integer

Unique identificator

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

The name of the country

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 table Description prepol

pol

Object

Port of loading. See table Description pol

pod

Object

Port of discharge. See table Description pod

postpod

Object

Destination. See table Description postpod

Description prepol

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.

Description pol

Parameter

Type

Description

location

Integer | Null

Unique identifier (id) from the locations array

date

String | Null

Date of arrival at port of loading

actual

True | False | Null

If the date is true - it was confirmed by carrier, if false - it is estimated, if null - not defined yet.

Description pod

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.

Description postpod

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.

Description vessels

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)

Description containers

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

Description events

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 table Event Codes

date

String

Event date

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 vesels array

voyage

String | Null

Sea voyage identifier

Event 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

Response example

        {
        "status": "success",
        "message": "OK",
        "data": {
            "locations": [
                {
                    "id": 1,
                    "name": "Chicago",
                    "state": "Illinois",
                    "country": "United States",
                    "country_code": "US",
                    "locode": null,
                    "lat": 41.85003,
                    "lng": -87.65005
                },
                {
                    "id": 2,
                    "name": "Mundra",
                    "state": "Gujarat",
                    "country": "India",
                    "country_code": "IN",
                    "locode": null,
                    "lat": 22.83918,
                    "lng": 69.7219
                },
                {
                    "id": 3,
                    "name": "Newark",
                    "state": "New Jersey",
                    "country": "United States",
                    "country_code": "US",
                    "locode": null,
                    "lat": 40.73566,
                    "lng": -74.17237
                },
                {
                    "id": 4,
                    "name": "Salalah",
                    "state": "Dhofar",
                    "country": "Oman",
                    "country_code": "OM",
                    "locode": "OMSLL",
                    "lat": 17.01505,
                    "lng": 54.09237
                }
            ],
                "route": {
                    "prepol": {
                        "location": 1,
                        "date": "2020-01-21 08:53:00"
                        },
                    "pol": {
                        "location": 1,
                        "date": "2020-01-16 16:46:00"
                    },
                    "pod": {
                        "location": 2,
                        "date": "2020-03-09 12:57:00"
                    },
                    "postpod": {
                        "location": 2,
                        "date": "2020-03-19 21:00:00"
                    }
                },
                "vessels": [
                    {
                        "id": 1,
                        "name": "GUNDE MAERSK",
                        "imo": 9359014,
                        "call_sign": "OUIY2",
                        "mmsi": 220594000,
                        "flag": "DK"
                    },
                    {
                        "id": 2,
                        "name": "GERD MAERSK",
                        "imo": 9320245,
                        "call_sign": "OYGM2",
                        "mmsi": 220415000,
                        "flag": "DK"
                    },
                    {
                        "id": 3,
                        "name": "MAERSK GUATEMALA",
                        "imo": 9713375,
                        "call_sign": "VROS7",
                        "mmsi": 477737700,
                        "flag": "HK"
                    }
                ],
                "containers": [ {
                    "number":
                        "MSKU5957789",
                        "iso_code": "22G1",
                        "events": [
                            {
                                "location": 1,
                                "description": "Gate in",
                                "status": "CGI",
                                "date": "2020-01-16 16:46:00",
                                "type": "land",
                                "vessel": 1,
                                "voyage": "952E"
                            },
                            {
                                "location": 1,
                                "description": "On rail",
                                "status": "UNK",
                                "date": "2020-01-16 17:29:00",
                                "type": "land",
                                "vessel": 1,
                                "voyage": "952E"
                            },
                            {
                                "location": 3,
                                "description": "Off rail",
                                "status": "UNK",
                                "date": "2020-01-19 10:22:00",
                                "type": "land",
                                "vessel": 1,
                                "voyage": "952E"
                            },
                            {
                                "location": 3,
                                "description": "Gate out",
                                "status": "CEP",
                                "date": "2020-01-21 08:53:00",
                                "type": "land",
                                "vessel": 1,
                                "voyage": "952E"
                            },
                            {
                                "location": 3,
                                "description": "Gate in",
                                "status": "VAT",
                                "date": "2020-01-21 08:55:00",
                                "type": "land",
                                "vessel": 1,
                                "voyage": "952E"
                            },
                            {
                                "location": 3,
                                "description": "Load",
                                "status": "CLL",
                                "date": "2020-01-23 01:31:00",
                                "type": "land",
                                "vessel": 2,
                                "voyage": "951E"
                            },
                            {
                                "location": 4,
                                "description": "Discharge",
                                "status": "CDT",
                                "date": "2020-02-21 00:35:00",
                                "type": "land",
                                "vessel": 2,
                                "voyage": "005W"
                            },
                            {
                                "location": 4,
                                "description": "Load",
                                "status": "CLT",
                                "date": "2020-03-03 19:21:00",
                                "type": "land",
                                "vessel": 3,
                                "voyage": "006E"
                            },
                            {
                                "location": 2,
                                "description": "Discharge",
                                "status": "CDT",
                                "date": "2020-03-07 22:17:00",
                                "type": "land",
                                "vessel": 3,
                                "voyage": "006E"
                            },
                            {
                                "location": 2,
                                "description": "Gate out",
                                "status": "CGO",
                                "date": "2020-03-09 11:41:00",
                                "type": "land",
                                "vessel": 3,
                                "voyage": "006E"
                            },
                            {
                                "location": 2,
                                "description": "Gate in",
                                "status": "VAT",
                                "date": "2020-03-09 12:57:00",
                                "type": "land",
                                "vessel": 3,
                                "voyage": "006E"
                            },
                            {
                                "location": 2,
                                "description": "Stripping Empty",
                                "status": "CER",
                                "date": "2020-03-19 21:00:00",
                                "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 is true or false. The default is false. 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 quickly)

Request example

GET /container?number=MSKU5957789&sealine=maeu&api_key=XXXX-XXXX-XXXX-XXXX

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": "Chicago",
                                "state": "Illinois",
                                "country": "United States",
                                "country_code": "US",
                                "locode": null,
                                "lat": 41.85003,
                                "lng": -87.65005
                            },
                            {
                                "id": 2,
                                "name": "Mundra",
                                "state": "Gujarat",
                                "country": "India",
                                "country_code": "IN",
                                "locode": null,
                                "lat": 22.83918,
                                "lng": 69.7219
                            },
                            {
                                "id": 3,
                                "name": "Newark",
                                "state": "New Jersey",
                                "country": "United States",
                                "country_code": "US",
                                "locode": null,
                                "lat": 40.73566,
                                "lng": -74.17237
                            },
                            {
                                "id": 4,
                                "name": "Salalah",
                                "state": "Dhofar",
                                "country": "Oman",
                                "country_code": "OM",
                                "locode": "OMSLL",
                                "lat": 17.01505,
                                "lng": 54.09237
                            }
                        ],
                        "route": {
                            "prepol": {
                                "location": 1,
                                "date": "2020-01-21 08:53:00"
                            },
                                "pol": {
                                "location": 1,
                                "date": "2020-01-16 16:46:00"
                            }, "pod": {
                                "location": 2,
                                "date": "2020-03-09 12:57:00"
                            },
                                "postpod": {
                                "location": 2,
                                "date": "2020-03-19 21:00:00"
                            },
                            "vessels": [ {
                                "id": 1,
                                "name": "GUNDE MAERSK",
                                "imo": 9359014,
                                "call_sign": "OUIY2",
                                "mmsi": 220594000,
                                "flag": "DK"
                            },
                            {
                                "id": 2,
                                "name": "GERD MAERSK",
                                "imo": 9320245,
                                "call_sign": "OYGM2",
                                "mmsi": 220415000,
                                "flag": "DK"
                            },
                            {
                                "id": 3,
                                "name": "MAERSK GUATEMALA",
                                "imo": 9713375,
                                "call_sign": "VROS7",
                                "mmsi": 477737700,
                                "flag": "HK"
                            }
                        ],
                        "container": {
                            "number": "MSKU5957789",
                            "iso_code": "22G1",
                            "events": [
                                {
                                    "location": 1,
                                    "description": "Gate in",
                                    "status": "CGI",
                                    "date": "2020-01-16 16:46:00",
                                    "type": "land",
                                    "vessel": 1,
                                    "voyage": "952E"
                                },
                                {
                                    "location": 1,
                                    "description": "On rail",
                                    "status": "UNK",
                                    "date": "2020-01-16 17:29:00",
                                    "type": "land",
                                    "vessel": 1,
                                    "voyage": "952E"
                                },
                                {
                                    "location": 3,
                                    "description": "Off rail",
                                    "status": "UNK",
                                    "date": "2020-01-19 10:22:00",
                                    "type": "land",
                                    "vessel": 1,
                                    "voyage": "952E"
                                },
                                {
                                    "location": 3,
                                    "description": "Gate out",
                                    "status": "CEP",
                                    "date": "2020-01-21 08:53:00",
                                    "type": "land",
                                    "vessel": 1,
                                    "voyage": "952E"
                                },
                                {
                                    "location": 3,
                                    "description": "Gate in",
                                    "status": "VAT",
                                    "date": "2020-01-21 08:55:00",
                                    "type": "land",
                                    "vessel": 1,
                                    "voyage": "952E"
                                },
                                {
                                    "location": 3,
                                    "description": "Load",
                                    "status": "CLL",
                                    "date": "2020-01-23 01:31:00",
                                    "type": "land",
                                    "vessel": 2,
                                    "voyage": "951E"
                                },
                                {
                                    "location": 4,
                                    "description": "Discharge",
                                    "status": "CDT",
                                    "date": "2020-02-21 00:35:00",
                                    "type": "land",
                                    "vessel": 2,
                                    "voyage": "005W"
                                },
                                {
                                    "location": 4,
                                    "description": "Load",
                                    "status": "CLT",
                                    "date": "2020-03-03 19:21:00",
                                    "type": "land",
                                    "vessel": 3,
                                    "voyage": "006E"
                                },
                                {
                                    "location": 2,
                                    "description": "Discharge",
                                    "status": "CDT",
                                    "date": "2020-03-07 22:17:00",
                                    "type": "land",
                                    "vessel": 3,
                                    "voyage": "006E"
                                },
                                {
                                    "location": 2,
                                    "description": "Gate out",
                                    "status": "CGO",
                                    "date": "2020-03-09 11:41:00",
                                    "type": "land",
                                    "vessel": 3,
                                    "voyage": "006E"
                                },
                                {
                                    "location": 2,
                                    "description": "Gate in",
                                    "status": "VAT",
                                    "date": "2020-03-09 12:57:00",
                                    "type": "land",
                                    "vessel": 3,
                                    "voyage": "006E"
                                },
                                {
                                    "location": 2,
                                    "description": "Stripping Empty",
                                    "status": "CER",
                                    "date": "2020-03-19 21:00:00",
                                    "type": "land",
                                    "vessel": null,
                                    "voyage": null
                                }
                            ]
                        }
                    }
                }
            

List of Supported Shipping Lines

Shipping Line Name

SCAC

Auto Detect

AUTO

Maersk

MAEU

Yang Ming

YMLU

Hapag-Lloyd

HLCU

MSC

MSCU

CMA CGM

CMDU

Safmarine

SAFM

COSCO

COSU

APL

APLU

ZIM

ZIMU

OOCL

OOLU

Sealand

SEJJ

Evergreen

EGLV

ONE

ONEY

ARKAS

ARKU

TURKON

TRKU

HYUNDAI

HDMU

HAMBURG SUD

SUDU

Sinokor

SKLU

Wan Hai

22AA

Perma Shipping Line

PMLU

Interasia Lines

12AT

Korea Marine Transport (KMTC)

KMTU

Shipping Coporation of India (SCI)

SCIU

Regional Container Lines (RCL)

REGU

Trans Asian Shipping Services

TLXU

Sea Hawk Lines (SHAL)

SHKU

Emirates Shipping Line

ESPU

Avana Global FZCO

BLJU

BLPL Singapore

BLZU

Stolt Tank Containers (STC)

SNTU

Westwood Shipping Lines

WWSU

T.S. Lines

13DF

Sarjak Container Lines

SJKU

China Navigation Company (Swire Shipping)

CHVW

Matson Navigation Company Inc (MATS)

MATS

Emkay Lines

EMKU

SITC Container Lines

12PD

FESCO

FESO

Deutsche Afrika-Linien (DAL)

DAYU

China United Lines

CULU

Nile Dutch Africa Line

NIDU

SM Line Corporation (SML)

SMLM

Sinotrans Container Lines

12IH

Minsheng Ocean Shipping

13CQ

Mariana Express Lines (MELL)

MEXU

Pacific International Lines (PIL)

PCIU

Salam Pacific Indonesia Lines (SPIL)

SPNU

W.E.C. (West European Container) Lines

WECU

Atlantic Container Line (ACL)

ACLU

Admiral Container Lines

ADMU

Heung-A Shipping

11QU

Ignazio Messina

LMCU

Australia National Line (ANL)

ANNU

Pacific Direct Line (PDL)

PDLU

Crowley Maritime

CMCU

Ethiopian Shipping Line

ESLU

Pan Asia Line

PALU

Pan Continental Shipping

15AC

Marguisa Shipping Lines

MGSU

SETH Shipping

SSPH

Tropical

TSCW

BMC Line Shipping

BMSU

Maritime Marfret

MFTU

Dongjin Shipping

11PG

Namsung Shipping

NSRU

CNC (Cheng Lie Navigation)

11DX

ECU Worldwide

ECUW

Kambara Kisen

KKCL

TOTE Maritime

TOTE

Dong Young Shipping

PCSL

Sunmarine Shipping Services

BAXU

List of shipping lines that will be available in the near future

Shipping Line Name

SCAC

Tarros

GETU

Compania Sud Americana de Vapores SA (CSAV)

CHIW

Routes

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

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

Request parameters

type

CT,BL,BK

number

Number of container booking or B/L

sealine

SCAC code of shipping line

api_key

your API key

Response

                {
                    "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

string

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, longtitude]. It's a full route

type

string

LAND or SEA

pin

float | null

array of [latitude, longtitude] or null current pin position

If NOT_TRACKED you need to track it at first.