Skip to main content
Skip table of contents

Vessel State Service

(getVesselStates)

Returns historical vessel states for the given dates and imo numbers supplied.

Consumes

This API call consumes the following media types via the Content-Type request header:

application/json

Request body

body v3GetVesselStatesRequest (required)

Body Parameter —

Return type

v3VesselStatesResponse

Example data

Content-Type: application/json

{

"vesselStates" : [ {

"predictedDestinationPortId" : 7,

"predictedDestinationScore" : 1.2315135367772556,

"subSegment" : "subSegment",

"lastVisitedPortId" : 6,

"portId" : 5,

"destinationScore" : 4.145608029883936,

"lastVisitedPortName" : "lastVisitedPortName",

"berthName" : "berthName",

"ladenStatusDraught" : "ladenStatusDraught",

"relatedPortName" : "relatedPortName",

"eta" : "eta",

"segment" : "segment",

"destinationPortName" : "destinationPortName",

"zoneId" : 5,

"predictedDestinationPortName" : "predictedDestinationPortName",

"ladenStatusModel" : "ladenStatusModel",

"commodityGroup" : "commodityGroup",

"lastOpsPortName" : "lastOpsPortName",

"lastOpsPortId" : 7,

"anchorageName" : "anchorageName",

"shipyardName" : "shipyardName",

"vesselName" : "vesselName",

"dwt" : 1.4658129805029452,

"volumeOnBoard" : 1.1730742509559433,

"mmsi" : 6,

"destinationPortId" : 2,

"berthId" : 7,

"destination" : "destination",

"destinationCountryCode" : "destinationCountryCode",

"imo" : 0,

"vesselStatus" : "vesselStatus",

"portName" : "portName",

"navigationalStatus" : "navigationalStatus",

"speedStatus" : "speedStatus",

"predictedDestinationCountryCode" : "predictedDestinationCountryCode",

"shipyardId" : 9,

"zoneName" : "zoneName",

"relatedPortId" : 3,

"portCallStatus" : "portCallStatus",

"hoursCarriedForward" : 4,

"timestamp" : "timestamp",

"direction" : "direction",

"predictedDestinationRegion" : "predictedDestinationRegion",

"destinationRegion" : "destinationRegion",

"commodityId" : 1,

"anchorageId" : 2,

"vesselType" : "vesselType",

"navigationalStatusCode" : 1,

"commodityName" : "commodityName"

}, {

"predictedDestinationPortId" : 7,

"predictedDestinationScore" : 1.2315135367772556,

"subSegment" : "subSegment",

"lastVisitedPortId" : 6,

"portId" : 5,

"destinationScore" : 4.145608029883936,

"lastVisitedPortName" : "lastVisitedPortName",

"berthName" : "berthName",

"ladenStatusDraught" : "ladenStatusDraught",

"relatedPortName" : "relatedPortName",

"eta" : "eta",

"segment" : "segment",

"destinationPortName" : "destinationPortName",

"zoneId" : 5,

"predictedDestinationPortName" : "predictedDestinationPortName",

"ladenStatusModel" : "ladenStatusModel",

"commodityGroup" : "commodityGroup",

"lastOpsPortName" : "lastOpsPortName",

"lastOpsPortId" : 7,

"anchorageName" : "anchorageName",

"shipyardName" : "shipyardName",

"vesselName" : "vesselName",

"dwt" : 1.4658129805029452,

"volumeOnBoard" : 1.1730742509559433,

"mmsi" : 6,

"destinationPortId" : 2,

"berthId" : 7,

"destination" : "destination",

"destinationCountryCode" : "destinationCountryCode",

"imo" : 0,

"vesselStatus" : "vesselStatus",

"portName" : "portName",

"navigationalStatus" : "navigationalStatus",

"speedStatus" : "speedStatus",

"predictedDestinationCountryCode" : "predictedDestinationCountryCode",

"shipyardId" : 9,

"zoneName" : "zoneName",

"relatedPortId" : 3,

"portCallStatus" : "portCallStatus",

"hoursCarriedForward" : 4,

"timestamp" : "timestamp",

"direction" : "direction",

"predictedDestinationRegion" : "predictedDestinationRegion",

"destinationRegion" : "destinationRegion",

"commodityId" : 1,

"anchorageId" : 2,

"vesselType" : "vesselType",

"navigationalStatusCode" : 1,

"commodityName" : "commodityName"

} ]

}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

application/json

Responses

200

A successful response. v3VesselStatesResponse

default

An unexpected error response. rpcStatus

post /v3/vessel-states-for-date

(getVesselStatesForDate)

Returns all historical states for the entire fleet for a single date.

Consumes

This API call consumes the following media types via the Content-Type request header:

application/json

Request body

body v3GetVesselStatesForDateRequest (required)

Body Parameter —

Return type

v3VesselStatesResponse

Example data

Content-Type: application/json

{

"vesselStates" : [ {

"predictedDestinationPortId" : 7,

"predictedDestinationScore" : 1.2315135367772556,

"subSegment" : "subSegment",

"lastVisitedPortId" : 6,

"portId" : 5,

"destinationScore" : 4.145608029883936,

"lastVisitedPortName" : "lastVisitedPortName",

"berthName" : "berthName",

"ladenStatusDraught" : "ladenStatusDraught",

"relatedPortName" : "relatedPortName",

"eta" : "eta",

"segment" : "segment",

"destinationPortName" : "destinationPortName",

"zoneId" : 5,

"predictedDestinationPortName" : "predictedDestinationPortName",

"ladenStatusModel" : "ladenStatusModel",

"commodityGroup" : "commodityGroup",

"lastOpsPortName" : "lastOpsPortName",

"lastOpsPortId" : 7,

"anchorageName" : "anchorageName",

"shipyardName" : "shipyardName",

"vesselName" : "vesselName",

"dwt" : 1.4658129805029452,

"volumeOnBoard" : 1.1730742509559433,

"mmsi" : 6,

"destinationPortId" : 2,

"berthId" : 7,

"destination" : "destination",

"destinationCountryCode" : "destinationCountryCode",

"imo" : 0,

"vesselStatus" : "vesselStatus",

"portName" : "portName",

"navigationalStatus" : "navigationalStatus",

"speedStatus" : "speedStatus",

"predictedDestinationCountryCode" : "predictedDestinationCountryCode",

"shipyardId" : 9,

"zoneName" : "zoneName",

"relatedPortId" : 3,

"portCallStatus" : "portCallStatus",

"hoursCarriedForward" : 4,

"timestamp" : "timestamp",

"direction" : "direction",

"predictedDestinationRegion" : "predictedDestinationRegion",

"destinationRegion" : "destinationRegion",

"commodityId" : 1,

"anchorageId" : 2,

"vesselType" : "vesselType",

"navigationalStatusCode" : 1,

"commodityName" : "commodityName"

}, {

"predictedDestinationPortId" : 7,

"predictedDestinationScore" : 1.2315135367772556,

"subSegment" : "subSegment",

"lastVisitedPortId" : 6,

"portId" : 5,

"destinationScore" : 4.145608029883936,

"lastVisitedPortName" : "lastVisitedPortName",

"berthName" : "berthName",

"ladenStatusDraught" : "ladenStatusDraught",

"relatedPortName" : "relatedPortName",

"eta" : "eta",

"segment" : "segment",

"destinationPortName" : "destinationPortName",

"zoneId" : 5,

"predictedDestinationPortName" : "predictedDestinationPortName",

"ladenStatusModel" : "ladenStatusModel",

"commodityGroup" : "commodityGroup",

"lastOpsPortName" : "lastOpsPortName",

"lastOpsPortId" : 7,

"anchorageName" : "anchorageName",

"shipyardName" : "shipyardName",

"vesselName" : "vesselName",

"dwt" : 1.4658129805029452,

"volumeOnBoard" : 1.1730742509559433,

"mmsi" : 6,

"destinationPortId" : 2,

"berthId" : 7,

"destination" : "destination",

"destinationCountryCode" : "destinationCountryCode",

"imo" : 0,

"vesselStatus" : "vesselStatus",

"portName" : "portName",

"navigationalStatus" : "navigationalStatus",

"speedStatus" : "speedStatus",

"predictedDestinationCountryCode" : "predictedDestinationCountryCode",

"shipyardId" : 9,

"zoneName" : "zoneName",

"relatedPortId" : 3,

"portCallStatus" : "portCallStatus",

"hoursCarriedForward" : 4,

"timestamp" : "timestamp",

"direction" : "direction",

"predictedDestinationRegion" : "predictedDestinationRegion",

"destinationRegion" : "destinationRegion",

"commodityId" : 1,

"anchorageId" : 2,

"vesselType" : "vesselType",

"navigationalStatusCode" : 1,

"commodityName" : "commodityName"

} ]

}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

application/json

Responses

200

A successful response. v3VesselStatesResponse

default

An unexpected error response. rpcStatus

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.