Shipfinder API

Shipfinder, via Shipfinder API(Application Programming Interface), embeds ships position and map in user's business system or website simply and easily, helps users to create vessel management and monitoring system

Ship Data Ship Track Portofcall Data Single Ship Locate

Ship SearchSingle ShipMultiple ShipsArea Ships


Ship Search Interface, is an interface for users to get Shipfinder unique ShipID of any ship. Users can get ShipID with “Ship Name”, “Call Sign”, “IMO number”, “MMSI”

API Call
Parameter name Description
v Version Number:Version number is 2
k API Key :API key provided by Shipfinder (Authorization Key)
enc Encoding Form :0 - Binary Base64 encoding, 1 - Json. Default Value: 1
kw Key Word:Ship parameter, Ship Name/Call Sign/MMSI/IMO workable
tp Data Type :0- simple data, 1 -detailed data
max Max feedback of the request, should be not more than 100


▪ JSON Response

♢ Sample

Simple Data

{ "status":0, "data":[ { "MatchType":1, "ShipID":412569879, "From":1, "mmsi":412569879, "shiptype":54, "imo":0, "name":"COSCO", "callsign":"11111", "lasttime":1479162967 },{ "MatchType":1, "ShipID":368998997, "From":1, "mmsi":368998997, "shiptype":0, "imo":0, "name":"COSCO", "callsign":"2233355", "lasttime":1445835488 },{ "MatchType":1, "ShipID":413004439, "From":1, "mmsi":413004439, "shiptype":71, "imo":0, "name":"COSCO", "callsign":"910", "lasttime":1403231537 } ] }

Extended Data

{ "status":0, "data":[ { "MatchType":1, "ShipID":412569879, "From":1, "mmsi":412569879, "shiptype":54, "imo":0, "name":"COSCO", "callsign":"11111", "length":10220, "width":1020, "left":510, "trail":5110, "draught":0, "dest":"", "eta":"", "navistat":0, "lat":37489332, "lon":119901882, "sog":4630, "cog":34570, "hdg":51100, "rot":0, "lasttime":1479162967 },{ "MatchType":1, "ShipID":368998997, "From":1, "mmsi":368998997, "shiptype":0, "imo":0, "name":"COSCO", "callsign":"2233355", "length":360, "width":80, "left":40, "trail":180, "draught":0, "dest":"", "eta":"", "navistat":0, "lat":37546788, "lon":122093118, "sog":1749, "cog":27200, "hdg":51100, "rot":0, "lasttime":1445835488 },{ "MatchType":1, "ShipID":413004439, "From":1, "mmsi":413004439, "shiptype":71, "imo":0, "name":"COSCO", "callsign":"910", "length":1340, "width":220, "left":120, "trail":180, "draught":0, "dest":"", "eta":"", "navistat":0, "lat":39254680, "lon":122694672, "sog":51, "cog":32050, "hdg":32000, "rot":0, "lasttime":1403231537 }] }

♢ Response Fields

Parameter name Type Description
MatchType byte Matching type:
1-Ship Name; 2-Call Sign;3-MMSI; 5-IMO
ShipID uint64 Ship ID
From uint32 Source of the data:
0-Coastal AIS receiver;1-Statellite AIS receiver
mmsi uint32 MMSI
shiptype uint16 As per ship type code in API Documentation
imo uint32 0= Not available (default)
name string Ship Name
callsign string Call Sign
length uint16 Ship length, decimeter (0-10220)
width uint16 Ship beam, decimeter (0-1260]
left uint16 Distance to portside, decimeter(0-630]
trail uint16 Distance to stern, decimeter(0-5110)
draught uint16 Draft, millimeter(0-25500]
dest string Destination
eta byte[4] [MM][DD][HH][MM]
navistat uint16 Navigation status, status detail as per in API Documentation
lon int32 Longitude,
1/1000000 degree, [-180000000,18000000]
lat int32 Latitude
1/1000000 degree, [-90000000,90000000]
hdg uint16 Heading, 1/100 degree, [0,35900]
cog uint16 Course, 1/100 degree, [0,35990]
sog uint16 Speed, millimeter/second, [0,52576]
rot uint16 Rate of turn, 1/100 degree/second,
lasttime int64 Unix timestamp

▪ Binary Response

Parameter name Type Description
dataLength uint32 Length of the data
dataType uint16 Type of the data :Definition as per in API Documentation
resultcount uint32 Count of result
matchType byte Match type :1-Ship Name;2-Call Sig;3-MMSI;5-IMO number
ship information:1-tp=0,return shipSimple;
2-tp=1,return shipDetai