Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
GET https://api.portconnect.io/v1/scheduled-vessels

Query Parameters

Name

Description

portCode

UN code for the port. NZAKL, NZTRG, NZTIU or NZLYT.

vesselType

Either cruise or commercial

vesselStatus

One of expected, inport or departed

arrivalDateFrom

Filters vessels arriving from and including this date. YYYY-MM-DDTHH:MM:SS format

arrivalDateTo

Filters vessles arriving to and including this date. YYYY-MM-DDTHH:MM:SS format

Example Request:

This request will return all commercial vessels (excludes cruise ships) for Auckland that are expected to arrive between 2nd May 12:00am and 31st May 12:00 am:

...

Code Block
[
  {
    "vesselVisitReference": "ABCD1234",
    "vesselName": "Vessel1",
    "imoNumber": 1234567,
    "inboundVoyage": "Voyage1",
    "alternativeInboundVoyage": null,
    "outboundVoyage": null,
    "alternativeOutboundVoyage": null,
    "vesselStatus": "Expected",
    "vesselType": "Cruise",
    "portCode": "NZAKL",
    "wharfName": null,
    "previousPortName": null,
    "nextPortName": "NZAUK",
    "vesselOperator": "ShippingLine1",
    "serviceCode": null,
    "arrivalDatetime": "2023-04-15T08:00:00+12:00",
    "departureDatetime": null,
    "receivalCommenceInland": null,
    "receivalCommenceSeaport": null,
    "receivalCutoffInland": null,
    "rcvCommReeferinland": null,
    "rcvCommHazinland": null,
    "rcvCutoffHazinland": null,
    "rcvCommReeferSeaport": null,
    "rcvCommHazSeaport": null,
    "rcvCutoffHazSeaport": null,
    "receivalCutoffSeaport": null,
    "lastUpdatedDateTime": "2023-04-19T20:00:00+12:00",
    "visitPhase": "WORKING"
  }
]