POST api/VesselLatestPosition

Returns the latest position for a vessel or array of vessels

Request Information

URI Parameters

None.

Body Parameters

The IMO or MMSI number, or array of IMO or MMSI numbers, for the request

Name	Description	Type	Additional information
Identifiers		Collection of string	None.

Request Formats

application/json, text/json

Sample:

{
  "Identifiers": [
    "sample string 1",
    "sample string 2"
  ]
}

application/xml, text/xml

Sample:

<VesselIdentifiers xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Identifiers>
    <string>sample string 1</string>
    <string>sample string 2</string>
  </Identifiers>
</VesselIdentifiers>

Response Information

Resource Description

Collection of AisReport

Name	Type	Additional information
AisVersion	integer	None.
CallSign	string	None.
CourseOverGround	decimal number	None.
DateReceived	date	None.
Destination	string	None.
DimensionToBow	decimal number	None.
DimensionToPort	decimal number	None.
DimensionToStarboard	decimal number	None.
DimensionToStern	decimal number	None.
Draught	decimal number	None.
Dte	boolean	None.
EtaDay	integer	None.
EtaHour	integer	None.
EtaMinute	integer	None.
EtaMonth	integer	None.
ImoNumber	string	None.
ManeuverIndicator	string	None.
MessageType	string	None.
Mmsi	string	None.
NavigationStatus	string	None.
Position	CoordDec	None.
PositionAccuracy	boolean	None.
PositionFixType	string	None.
RaimFlag	boolean	None.
RateOfTurn	integer	None.
ShipType	string	None.
SpeedOverGround	Speed	None.
TrueHeading	integer	None.
VesselName	string	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "AisVersion": 1,
    "CallSign": "sample string 1",
    "CourseOverGround": 1.1,
    "DateReceived": "2024-11-21T05:28:46.1858643+00:00",
    "Destination": "sample string 2",
    "DimensionToBow": 1.1,
    "DimensionToPort": 1.1,
    "DimensionToStarboard": 1.1,
    "DimensionToStern": 1.1,
    "Draught": 1.1,
    "Dte": true,
    "EtaDay": 1,
    "EtaHour": 1,
    "EtaMinute": 1,
    "EtaMonth": 1,
    "ImoNumber": "sample string 3",
    "ManeuverIndicator": "sample string 4",
    "MessageType": "sample string 5",
    "Mmsi": "sample string 6",
    "NavigationStatus": "sample string 7",
    "Position": {
      "lat": 1.1,
      "lon": 2.1
    },
    "PositionAccuracy": true,
    "PositionFixType": "sample string 8",
    "RaimFlag": true,
    "RateOfTurn": 1,
    "ShipType": "sample string 9",
    "SpeedOverGround": {
      "Knots": 1.1,
      "Kph": 2.0372,
      "Mph": 1.2658573928,
      "Ms": 0.5658888889
    },
    "TrueHeading": 1,
    "VesselName": "sample string 10"
  },
  {
    "AisVersion": 1,
    "CallSign": "sample string 1",
    "CourseOverGround": 1.1,
    "DateReceived": "2024-11-21T05:28:46.1858643+00:00",
    "Destination": "sample string 2",
    "DimensionToBow": 1.1,
    "DimensionToPort": 1.1,
    "DimensionToStarboard": 1.1,
    "DimensionToStern": 1.1,
    "Draught": 1.1,
    "Dte": true,
    "EtaDay": 1,
    "EtaHour": 1,
    "EtaMinute": 1,
    "EtaMonth": 1,
    "ImoNumber": "sample string 3",
    "ManeuverIndicator": "sample string 4",
    "MessageType": "sample string 5",
    "Mmsi": "sample string 6",
    "NavigationStatus": "sample string 7",
    "Position": {
      "lat": 1.1,
      "lon": 2.1
    },
    "PositionAccuracy": true,
    "PositionFixType": "sample string 8",
    "RaimFlag": true,
    "RateOfTurn": 1,
    "ShipType": "sample string 9",
    "SpeedOverGround": {
      "Knots": 1.1,
      "Kph": 2.0372,
      "Mph": 1.2658573928,
      "Ms": 0.5658888889
    },
    "TrueHeading": 1,
    "VesselName": "sample string 10"
  }
]

application/xml, text/xml

Sample:

<ArrayOfAisReport xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AisReport>
    <AisVersion>1</AisVersion>
    <CallSign>sample string 1</CallSign>
    <CourseOverGround>1.1</CourseOverGround>
    <DateReceived>2024-11-21T05:28:46.1858643+00:00</DateReceived>
    <Destination>sample string 2</Destination>
    <DimensionToBow>1.1</DimensionToBow>
    <DimensionToPort>1.1</DimensionToPort>
    <DimensionToStarboard>1.1</DimensionToStarboard>
    <DimensionToStern>1.1</DimensionToStern>
    <Draught>1.1</Draught>
    <Dte>true</Dte>
    <EtaDay>1</EtaDay>
    <EtaHour>1</EtaHour>
    <EtaMinute>1</EtaMinute>
    <EtaMonth>1</EtaMonth>
    <ImoNumber>sample string 3</ImoNumber>
    <ManeuverIndicator>sample string 4</ManeuverIndicator>
    <MessageType>sample string 5</MessageType>
    <Mmsi>sample string 6</Mmsi>
    <NavigationStatus>sample string 7</NavigationStatus>
    <Position>
      <lat>1.1</lat>
      <lon>2.1</lon>
    </Position>
    <PositionAccuracy>true</PositionAccuracy>
    <PositionFixType>sample string 8</PositionFixType>
    <RaimFlag>true</RaimFlag>
    <RateOfTurn>1</RateOfTurn>
    <ShipType>sample string 9</ShipType>
    <SpeedOverGround>
      <Knots>1.1</Knots>
    </SpeedOverGround>
    <TrueHeading>1</TrueHeading>
    <VesselName>sample string 10</VesselName>
  </AisReport>
  <AisReport>
    <AisVersion>1</AisVersion>
    <CallSign>sample string 1</CallSign>
    <CourseOverGround>1.1</CourseOverGround>
    <DateReceived>2024-11-21T05:28:46.1858643+00:00</DateReceived>
    <Destination>sample string 2</Destination>
    <DimensionToBow>1.1</DimensionToBow>
    <DimensionToPort>1.1</DimensionToPort>
    <DimensionToStarboard>1.1</DimensionToStarboard>
    <DimensionToStern>1.1</DimensionToStern>
    <Draught>1.1</Draught>
    <Dte>true</Dte>
    <EtaDay>1</EtaDay>
    <EtaHour>1</EtaHour>
    <EtaMinute>1</EtaMinute>
    <EtaMonth>1</EtaMonth>
    <ImoNumber>sample string 3</ImoNumber>
    <ManeuverIndicator>sample string 4</ManeuverIndicator>
    <MessageType>sample string 5</MessageType>
    <Mmsi>sample string 6</Mmsi>
    <NavigationStatus>sample string 7</NavigationStatus>
    <Position>
      <lat>1.1</lat>
      <lon>2.1</lon>
    </Position>
    <PositionAccuracy>true</PositionAccuracy>
    <PositionFixType>sample string 8</PositionFixType>
    <RaimFlag>true</RaimFlag>
    <RateOfTurn>1</RateOfTurn>
    <ShipType>sample string 9</ShipType>
    <SpeedOverGround>
      <Knots>1.1</Knots>
    </SpeedOverGround>
    <TrueHeading>1</TrueHeading>
    <VesselName>sample string 10</VesselName>
  </AisReport>
</ArrayOfAisReport>