Share via


Maersk (Independent Publisher) (Preview)

Custom connector for Maersk shipping data including locations, vessels, schedules, and ports. This is public reference data.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Dan Romano
Email [email protected]
Connector Metadata
Publisher Dan Romano
Website https://developer.maersk.com/api-catalogue
Privacy policy https://terms.maersk.com/privacy
Categories Data

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get active ports

Returns a list of active ports of Load or Discharge called by A.P. Moller-Maersk A/S vessels

Get carrier location by Geo ID

Returns a list of locations by geo ID

Get list of locations

Returns a list of Maersk-supported locations.

Get shipment deadlines

Returns a list of shipment deadlines per terminal for a given vessel/voyage/port of load.

Get vessel information

Returns a list of active vessels operated by A.P. Moller-Maersk A/S

Get vessel schedules by port

Returns scheduled port calls for the provided filters.

Get vessel schedules by vessel

Returns schedules of vessel port calls for the given vessel and voyage filters.

Get active ports

Returns a list of active ports of Load or Discharge called by A.P. Moller-Maersk A/S vessels

Parameters

Name Key Required Type Description
Carrier Codes
carrierCodes True string

One or more carrier codes (e.g., MAEU). Comma-separated if multiple.

Country Codes
countryCodes string

Optional ISO 3166-1 alpha-2 country codes (e.g., US, CN)

Returns

response
array of Port

Get carrier location by Geo ID

Returns a list of locations by geo ID

Parameters

Name Key Required Type Description
Carrier Geo ID
carrierGeoID True string

Maersk carrier Geo ID

Returns

Get list of locations

Returns a list of Maersk-supported locations.

Returns

Get shipment deadlines

Returns a list of shipment deadlines per terminal for a given vessel/voyage/port of load.

Parameters

Name Key Required Type Description
ISO Country Code
ISOCountryCode True string

ISO country code of the port (e.g., US)

Port of Load
portOfLoad True string

City or port name (e.g., Houston)

Vessel IMO Number
vesselIMONumber True string

IMO number of the vessel

Voyage
voyage True string

Voyage number (e.g., 010E)

Returns

Get vessel information

Returns a list of active vessels operated by A.P. Moller-Maersk A/S

Parameters

Name Key Required Type Description
IMO vessel numbers
vesselIMONumbers string

Comma-separated IMO numbers (e.g., "9332999,9458030")

Carrier vessel codes
carrierVesselCodes string

Comma-separated list of values (e.g., "9332999,9458030")

Returns

response
array of Vessel

Get vessel schedules by port

Returns scheduled port calls for the provided filters.

Parameters

Name Key Required Type Description
UN Location Code
UNLocationCode string

United Nations location code for the port (e.g., USHOU). Required if cityName and carrierGeoID are not provided.

City Name
cityName string

Name of the port city. Required if UNLocationCode and carrierGeoID are not provided.

Carrier Geo ID
carrierGeoID string

Maersk internal location identifier. Required if UNLocationCode and cityName are not provided.

Start Date
startDate date

Start date for the port schedule

Date Range
dateRange string

Range from the start date

Carrier Codes
carrierCodes True string

Required carrier code(s)

Returns

Get vessel schedules by vessel

Returns schedules of vessel port calls for the given vessel and voyage filters.

Parameters

Name Key Required Type Description
Vessel IMO Number
vesselIMONumber string

7-digit IMO number for the vessel

Carrier Vessel Code
carrierVesselCode string

3-character Maersk vessel code

Start Date
startDate date

Start date for the schedule

Date Range
dateRange string

Range from the start date

Carrier Codes
carrierCodes True string

Carrier code(s), required by Maersk

Returns

Definitions

Location

Name Path Type Description
countryCode
countryCode string
countryName
countryName string
cityName
cityName string
locationType
locationType string
locationName
locationName string
carrierGeoID
carrierGeoID string
UNRegionCode
UNRegionCode string
UNRegionName
UNRegionName string

CarrierLocation

Name Path Type Description
countryCode
countryCode string
countryName
countryName string
cityName
cityName string
locationType
locationType string
locationName
locationName string
carrierGeoID
carrierGeoID string
carrierRkstCode
carrierRkstCode string
carrierRktsCode
carrierRktsCode string
timeZoneID
timeZoneID string
carrierCountryGeoID
carrierCountryGeoID string
UNLocationCode
UNLocationCode string
UNRegionCode
UNRegionCode string
UNRegionName
UNRegionName string

Vessel

Name Path Type Description
vesselIMONumber
vesselIMONumber string
carrierVesselCode
carrierVesselCode string
vesselName
vesselName string
vesselFlagCode
vesselFlagCode string
vesselCallSign
vesselCallSign string

Port

Name Path Type Description
countryCode
countryCode string
countryName
countryName string
UNLocationCode
UNLocationCode string
cityName
cityName string
portName
portName string
UNRegionCode
UNRegionCode string
carrierCityGeoID
carrierCityGeoID string

Facility

Name Path Type Description
locationType
locationType string
locationName
locationName string
carrierTerminalCode
carrierTerminalCode string
carrierTerminalGeoID
carrierTerminalGeoID string

Service

Name Path Type Description
carrierVoyageNumber
carrierVoyageNumber string
carrierServiceCode
carrierServiceCode string
carrierServiceName
carrierServiceName string

CallSchedule

Name Path Type Description
transportEventTypeCode
transportEventTypeCode string
eventClassifierCode
eventClassifierCode string
classifierDateTime
classifierDateTime date-time

FacilityCall

Name Path Type Description
vessel
transport.vessel Vessel
inboundService
transport.inboundService Service
outboundService
transport.outboundService Service
callSchedules
callSchedules array of CallSchedule

PortCall

Name Path Type Description
facility
facility Facility
facilityCalls
facilityCalls array of FacilityCall

VesselCall

Name Path Type Description
facility
facility Facility
inboundService
transport.inboundService Service
outboundService
transport.outboundService Service
callSchedules
callSchedules array of CallSchedule

PortSchedule

Name Path Type Description
port
port Port
portCalls
portCalls array of PortCall

VesselSchedule

Name Path Type Description
vessel
vessel Vessel
vesselCalls
vesselCalls array of VesselCall

ShipmentDeadline

The list of deadlines for each terminal for the specified vessel/voyage/port combination.

Name Path Type Description
terminalName
shipmentDeadlines.terminalName string

Name of the terminal at the port of load

deadlines
shipmentDeadlines.deadlines array of object
deadlineName
shipmentDeadlines.deadlines.deadlineName string

The name of the deadline

deadlineLocal
shipmentDeadlines.deadlines.deadlineLocal date-time

The deadline timestamp in local time