v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Transportation

Port calls - schedule vs actual arrival/departure (Fintraffic Portnet)

Finnish port-call schedule with estimated (ETA/ETD) and actual (ATA/ATD) arrival and departure times, plus the Sugra-computed delay (actual minus estimate) per call, from Fintraffic Digitraffic Portnet. Filter by port (UN/LOCODE), vessel (MMSI or IMO), date and status. Finnish ports only; schedule data filed by agents and the port, revised as they update it - not a navigational product.

get/api/v2/transport/ports/port-calls

Query parameters

portstring nullable

Port filter, UN/LOCODE, e.g. FIHEL (Helsinki), FIKTK (Kotka).

Example:FIHEL

Port filter, UN/LOCODE, e.g. FIHEL (Helsinki), FIKTK (Kotka).

datestring nullable

Port calls RECEIVED (registered or updated) on this date, YYYY-MM-DD UTC; default today. Portnet 'received' semantics - the record date, not the arrival date, so a call received today may have an ETA on another day.

Example:2026-07-24

Port calls RECEIVED (registered or updated) on this date, YYYY-MM-DD UTC; default today. Portnet 'received' semantics - the record date, not the arrival date, so a call received today may have an ETA on another day.

mmsiinteger nullable

Filter to one vessel by MMSI.

Filter to one vessel by MMSI.

imointeger nullable

Filter to one vessel by IMO number.

Filter to one vessel by IMO number.

status'scheduled' | 'arrived' | 'departed' nullable

Filter by call status: scheduled | arrived | departed.

Filter by call status: scheduled | arrived | departed.

limitinteger

Maximum port calls to return.

Maximum port calls to return.

Response

Successful Response

Example response

{
  "data": {
    "query": {
      "port": "FIHEL",
      "date": "2026-07-24",
      "mmsi": 230629000,
      "imo": 9606900,
      "status": "arrived",
      "limit": 100
    },
    "total_matched": 42,
    "count": 42,
    "port_calls": [
      {
        "port_call_id": 3319383,
        "vessel": {
          "name": "Viking Grace",
          "imo": 9606900,
          "mmsi": 230629000,
          "nationality": "FI",
          "type_code": 20
        },
        "port": "FITKU",
        "prev_port": "SEGRH",
        "next_port": "SEGRH",
        "berth_code": "v1",
        "berth_name": "viking1",
        "port_area_code": "PASSE",
        "port_area_count": 1,
        "eta": "2026-07-24T16:50:00.000Z",
        "eta_source": "Agent",
        "ata": "2026-07-24T09:58:00.000Z",
        "ata_source": "Agent",
        "etd": "2026-07-24T17:55:00.000Z",
        "etd_source": "Agent",
        "atd": "2026-07-24T10:37:00.000Z",
        "atd_source": "Agent",
        "arrival_delay_minutes": -2,
        "departure_delay_minutes": 7,
        "status": "arrived"
      }
    ],
    "coverage": "Finnish ports only (Fintraffic Portnet).",
    "attribution": {
      "sources": [
        {
          "registry_key": "noaa/aviation-weather-center",
          "source_name": "NOAA Aviation Weather Center",
          "licence": "public-domain",
          "citation": "NOAA/NWS Aviation Weather Center (aviationweather.gov)",
          "disclaimer": "Advisory only; not a substitute for an official preflight briefing."
        }
      ],
      "effective_reexport": "allowed"
    }
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}