Maersk

Maersk Schedules API

Retrieve point-to-point sailing options and commercial service schedules for Maersk ocean routes. Returns vessel, voyage, transit time, and intermediate transshipments for a given origin, destination, and date range.

Maersk Schedules API is one of 9 APIs that Maersk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Shipping, Schedules, Ocean, and DCSA. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

Documentation GitHub OpenAPI

OpenAPI Specification

openapi: 3.1.0
info:
  title: Maersk Schedules API
  description: >
    Point-to-Point and Commercial Schedules API for ocean shipping. Retrieve
    sailing schedules, vessel routes, and transit times between origin and
    destination ports. DCSA-aligned schedule structures.
  version: '2.0'
  contact:
    name: Maersk Developer Support
    url: https://developer.maersk.com/support

servers:
  - url: https://api.maersk.com
    description: Production Gateway

security:
  - ConsumerKey: []

tags:
  - name: Schedules
    description: Sailing schedules and vessel routings.

paths:
  /products/ocean-products/point-to-point:
    get:
      summary: Get Point To Point Schedules
      description: >
        Returns sailing options between an origin and destination port for a
        given date range, including vessel, voyage, transit time, and
        intermediate transshipments.
      operationId: getPointToPointSchedules
      tags:
        - Schedules
      parameters:
        - name: collectionOriginCountryCode
          in: query
          required: true
          schema:
            type: string
            example: DK
        - name: collectionOriginCityName
          in: query
          required: true
          schema:
            type: string
            example: Aarhus
        - name: deliveryDestinationCountryCode
          in: query
          required: true
          schema:
            type: string
            example: US
        - name: deliveryDestinationCityName
          in: query
          required: true
          schema:
            type: string
            example: Newark
        - name: dateRange
          in: query
          description: Departure date range in ISO 8601, e.g. P4W.
          schema:
            type: string
            example: P4W
        - name: startDate
          in: query
          required: true
          schema:
            type: string
            format: date
        - name: Consumer-Key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Schedules returned.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SchedulePoint'

  /dcsa/cs/v1/service-schedules:
    get:
      summary: Get Commercial Service Schedules
      description: >
        Retrieve commercial service schedules per DCSA Commercial Schedules
        interface. Returns the planned port rotations for a carrier service.
      operationId: getServiceSchedules
      tags:
        - Schedules
      parameters:
        - name: carrierServiceCode
          in: query
          schema:
            type: string
        - name: UNLocationCode
          in: query
          schema:
            type: string
        - name: Consumer-Key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Service schedules returned.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ServiceSchedule'

components:
  securitySchemes:
    ConsumerKey:
      type: apiKey
      in: header
      name: Consumer-Key
  schemas:
    SchedulePoint:
      type: object
      properties:
        transportSchedules:
          type: array
          items:
            type: object
            properties:
              vesselName:
                type: string
              vesselIMONumber:
                type: string
              carrierServiceCode:
                type: string
              carrierVoyageNumber:
                type: string
              departureDateTime:
                type: string
                format: date-time
              arrivalDateTime:
                type: string
                format: date-time
              transitTime:
                type: integer
                description: Transit time in days.
    ServiceSchedule:
      type: object
      properties:
        carrierServiceCode:
          type: string
        carrierServiceName:
          type: string
        vesselSchedules:
          type: array
          items:
            type: object
            properties:
              vesselIMONumber:
                type: string
              transportCalls:
                type: array
                items:
                  type: object
                  properties:
                    UNLocationCode:
                      type: string
                    portCallStatusCode:
                      type: string
                    plannedArrivalDate:
                      type: string
                      format: date-time
                    plannedDepartureDate:
                      type: string
                      format: date-time

Maersk Schedules API

Documentation

Specifications

Other Resources

OpenAPI Specification