How can we help?

ShipID - Where the real maritime intelligence lies

Featured
Follow
Avatar
Thanos Zelios

You have been receiving Ship ID for some time now in the response of many of the API services.

It is a unique identifier which helps overcome the struggle of tracking vessels with MMSI or IMO. Shipid - a MarineTraffic intelligence product - eliminates duplicates and helps keep track of changes in the most reliable way.

The API services in which the ship ID can be used as a search parameter are the following: 

  • PS01 - Vessel Historical Track
  • PS07 - Single Vessel Positions
  • EV01 - Port Calls
  • EV02 - Vessel Events
  • VD01 - Vessel Photos
  • VD02 - Vessel Particulars
  • VD03 - Search Vessel
  • VI01 - Voyage Forecasts
  • VI03 - Port Distances and Routes
  • PU01 - Change Fleet

Feel free to comment below the new feature and suggest any new ones!

0

Comments

4 comments

Sort by Date Votes
  • Avatar
    David Corni

    I suggest you let people know how to find the shipid.  I sure can't.  And you are correct, it is required for several API calls.  Sadly, the API calls also state imo and mmsi are also used, but the API's don't work with only those, you have to have the shipid.  So where in creation do you find the shipid for a vessel?  What do I have to do to be able to see the shipid?  It is not listed in the vessel information, as one might expect.  Is there an API call to get the shipid, and does that API call require the shipid to get the shipid?

    Sorry, but I am just a little frustrated with shipid.

    0
    Comment actions Permalink
  • Avatar
    Valia Gelasiou

    Dear David,

    Thank you for your comment,

    You could find the shipid of each vessel at the URL of the vessel details page in our website, for example: https://www.marinetraffic.com/el/ais/details/ships/shipid:201720/mmsi:636092706/imo:9689574/vessel:NORDIC_NAVID

    Another solution would be to utilise the VD03 API to retrieve the shipid since you already have the MMSI and IMO. You could request the service here: https://www.marinetraffic.com/el/ais-api-services/detail/vd03/search-vessel/

    Most of the APIs work with either using one of the vessel identifiers, specifically the IMO or MMSI or SHIPID. Please note that one of those should be specified in a call and not a combination.

    An example for the vessel Nordic Navid:

    /portcalls/{api_key}?v=4&timespan=2&shipid=201720&msgtype=simple&protocol=xml
    or
    /portcalls/{api_key}?v=4&timespan=2&mmsi=636092706&msgtype=simple&protocol=xml
    or
    /portcalls/{api_key}?v=4&timespan=2&imo=9689574&msgtype=simple&protocol=xml 

    Please let us know if you have further questions,

    Kind regards

    0
    Comment actions Permalink
  • Avatar
    Suresh Abeyweera

    hi @Valia Gelasiou,

    In the VD 03 - Search by name cant find the on demand API accesibility.

    Could you advise why is it. is it only subscription based ?

    Cant I check the VD03.

    0
    Comment actions Permalink
  • Avatar
    Anastasiya (she/her)

    Hello Sureh, 

    Thank you for reaching out. 

    We have sent you an email requesting some additional information needed for further assistance. Please check the email and come back to the Support Team. 

    In the meantime, we remain at your disposal. 

    Kind regards, 

    0
    Comment actions Permalink

Please sign in to leave a comment.

Didn't find what you were looking for?

New post