naftiko: 1.0.0-alpha2
info:
  label: Maersk Track and Trace API — Shipments
  description: >
    Retrieve neutralized container and shipment milestones via the Maersk
    Track and Trace API. Self-contained Naftiko capability covering shipment
    and event lookup.
  tags:
    - Maersk
    - Tracking
    - Shipping
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      MAERSK_CONSUMER_KEY: MAERSK_CONSUMER_KEY
capability:
  consumes:
    - type: http
      namespace: tracking-shipments
      baseUri: https://api.maersk.com
      description: Maersk Track and Trace shipment lookup.
      resources:
        - name: shipments
          path: /track-and-trace-private/shipments
          operations:
            - name: listShipmentEvents
              method: GET
              description: Retrieve tracking events for a shipment.
              inputParameters:
                - name: equipmentReference
                  in: query
                  type: string
                  description: Container number.
                - name: carrierBookingReference
                  in: query
                  type: string
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: events
          path: /track-and-trace-private/events
          operations:
            - name: listContainerEvents
              method: GET
              description: Retrieve fine-grained container events.
              inputParameters:
                - name: equipmentReference
                  in: query
                  type: string
                  required: true
                - name: eventType
                  in: query
                  type: string
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: apikey
        in: header
        name: Consumer-Key
        valueFrom: env.MAERSK_CONSUMER_KEY