Transportation

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

Changed on

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

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v2/transport/ports/port-calls
  • Auth: API key in header x-api-key

Query parameters

portstring nullable

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

Example:FIHEL
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
mmsiinteger nullable

Filter to one vessel by MMSI.

imointeger nullable

Filter to one vessel by IMO number.

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

Filter by call status: scheduled | arrived | departed.

limitinteger

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

  • bb59bcb0e35fRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • d2472ec2cf81Revision changes
    • info

      added the non-success response with the status