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

VesselIdentifiers
NameDescriptionTypeAdditional 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
NameDescriptionTypeAdditional 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-12-14T20:34:56.8562076+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-12-14T20:34:56.8562076+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-12-14T20:34:56.8562076+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-12-14T20:34:56.8562076+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>