---
title: "Get schedules between two ports"
method: GET
path: "/schedules/point-to-point"
tags: ["Schedule point-to-point"]
---

# Get schedules between two ports

`GET /schedules/point-to-point`

Get the maritime schedules between two ports (point-to-point). Provide the destination port UN/LOCODE (required) and, optionally, an origin port, the sealines and a departure date to refine the search.

## Query parameters

- `sealines` string[]
- `dateFrom` string, yyyy-MM-dd
- `unlocodeOrigin` string
- `unlocodeDestination` string, required

## Response `200`

Schedule found

- Schedule
  - `metadata` Metadata
    - `type` 'PORT' | 'POINT-TO-POINT' | 'VESSEL'
    - `vessel` VesselMetadata
      - `imo` integer
    - `port` PortMetadata
      - `unlocode` string
    - `pointToPoint` PointToPointMetadata
      - `origin` string
      - `destination` string
  - `vesselSchedules` VesselSchedule[]
    - `scheduleId` string
    - `sealineName` string
    - `sealine` string
    - `allVoyages` AllVoyage[]
    - `updatedAt` string, date-time
    - `serviceCode` string
    - `serviceName` string
    - `vesselImo` integer
    - `vesselName` string
    - `callingPorts` CallingPort[]
      - `orderId` integer
      - `terminalCode` string
      - `terminalName` string
      - `estimatedDates` ScheduleDates
        - `arrivalDate` string, yyyy-MM-dd — In port local time
        - `departureDate` string, yyyy-MM-dd — In port local time
        - `berthDate` string, yyyy-MM-dd — In port local time
      - `actualDates` ScheduleDates
        - `arrivalDate` string, yyyy-MM-dd — In port local time
        - `departureDate` string, yyyy-MM-dd — In port local time
        - `berthDate` string, yyyy-MM-dd — In port local time
      - `cutOffDates` CutOfDate[]
        - `name` string, yyyy-MM-dd
      - `voyages` Voyage[]
        - `name` string
        - `voyage` string
      - `portName` string
      - `portUnlocode` string
  - `portSchedules` PortSchedule[]
    - `scheduleId` string
    - `sealineName` string
    - `sealine` string
    - `allVoyages` AllVoyage[]
    - `updatedAt` string, date-time
    - `callingVessels` CallingVessel[]
      - `orderId` integer
      - `terminalCode` string
      - `terminalName` string
      - `estimatedDates` ScheduleDates
        - `arrivalDate` string, yyyy-MM-dd — In port local time
        - `departureDate` string, yyyy-MM-dd — In port local time
        - `berthDate` string, yyyy-MM-dd — In port local time
      - `actualDates` ScheduleDates
        - `arrivalDate` string, yyyy-MM-dd — In port local time
        - `departureDate` string, yyyy-MM-dd — In port local time
        - `berthDate` string, yyyy-MM-dd — In port local time
      - `cutOffDates` CutOfDate[]
        - `name` string, yyyy-MM-dd
      - `voyages` Voyage[]
        - `name` string
        - `voyage` string
      - `vesselName` string
      - `vesselImo` integer
      - `serviceCode` string
      - `serviceName` string
  - `pointToPointSchedules` PointToPointSchedule[]
    - `scheduleId` string
    - `sealineName` string
    - `sealine` string
    - `updatedAt` string, date-time
    - `transitTime` integer
    - `direct` boolean
    - `legs` Leg[]
      - `orderId` integer
      - `mode` string
      - `vesselImo` integer
      - `vesselName` string
      - `voyages` Voyage[]
        - `name` string
        - `voyage` string
      - `departure` PointLocation
        - `estimatedDate` string, yyyy-MM-dd — Local time
        - `portName` string
        - `portUnlocode` string
        - `terminalName` string
        - `terminalCode` string
      - `arrival` PointLocation
        - `estimatedDate` string, yyyy-MM-dd — Local time
        - `portName` string
        - `portUnlocode` string
        - `terminalName` string
        - `terminalCode` string
      - `serviceName` string
      - `serviceCode` string

---

[API](https://skmtc.net/safecube/apis/api-container-tracking.md) · [All operations](https://skmtc.net/safecube/apis/api-container-tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safecube/api-container-tracking/versions/e74a670ab7a5/schema)