# Digitraffic

> Use Finland's live traffic data in a workflow. Digitraffic is Fintraffic's open data service for rail, road and sea. Get a station's next departures with delays and their causes, find trains between two stations, follow a train, see its carriages and where it is now, and read station announcements. Read road traffic messages and roadworks, road weather stations, weather camera pictures, traffic volumes and road condition forecasts. Find ships near a place, look one up, list a port's arrivals and departures, and check faults in buoys and lights. Triggers fire on a new road traffic message and on a train running late at a station. No account or API key required.

App · 17 actions. Web page: https://docs.lodol.com/docs/integrations/digitraffic

## Actions

### Find ships near a place

Find the ships near a point in Finnish waters from their AIS broadcasts: name, kind of ship, whether it is moving, moored or at anchor, speed, course, destination and distance, nearest first.

**Inputs**

- Latitude (`latitude`, number, required): Latitude of the point, such as 60.1675 for Helsinki. From -90 to 90.
- Longitude (`longitude`, number, required): Longitude of the point, such as 24.95 for Helsinki. From -180 to 180.
- Radius in km (`radius_km`, number): How far around the point to look. Defaults to 5 km. From 0.1 to 50. Default: `5`.
- Only moving ships (`moving_only`, true/false): Leave out ships that are moored, anchored or stopped. Default: `false`.
- How many to return (`limit`, number): How many ships to return, nearest first. Defaults to 25. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many ships are listed
- `latitude` (number): The latitude searched around
- `longitude` (number): The longitude searched around
- `matched_count` (number): How many were found before the limit
- `moving_count` (number): How many of them are moving
- `radius_km` (number): The search radius in km
- `ships` (list): The ships, nearest first

**Example output**

```json
{
  "count": 2,
  "latitude": 60.1675,
  "longitude": 24.95,
  "matched_count": 34,
  "moving_count": 2,
  "radius_km": 3.0,
  "ships": [
    {
      "call_sign": "OF-3325",
      "course": 337.5,
      "destination": "SUOMENLINNA FERRY",
      "distance_km": 0.35,
      "heading": 353,
      "imo": null,
      "latitude": 60.167417,
      "longitude": 24.956413,
      "mmsi": 230108610,
      "name": "SUOKKI",
      "navigation_status": "Moored",
      "position_time": "2026-10-20T03:09:37Z",
      "ship_type": "Passenger ship",
      "ship_type_code": 60,
      "speed_knots": 0.0
    },
    {
      "call_sign": "OJLE",
      "course": 299.7,
      "destination": "SUOMENLINNA FERRY",
      "distance_km": 0.61,
      "heading": 299,
      "imo": 9315408,
      "latitude": 60.165093,
      "longitude": 24.959815,
      "mmsi": 230985490,
      "name": "SUOMENLINNA II",
      "navigation_status": "Under way using engine",
      "position_time": "2026-10-20T03:11:33Z",
      "ship_type": "Passenger ship",
      "ship_type_code": 60,
      "speed_knots": 6.3
    }
  ]
}
```

### Find trains between two stations

Find the trains that run from one station to another: when each leaves and arrives, how long it takes, the track and any delay or cancellation. Leave the date empty for the next trains from now, or pick a day to see its whole timetable.

**Inputs**

- From (`from_station`, text, required): The station to leave from: pick it, or type its name or short code.
- To (`to_station`, text, required): The station to travel to: pick it, or type its name or short code.
- Date (`date`, date): The day to travel. Leave it empty for the next trains from now.
- How many trains (`how_many`, number): How many trains to list, in order of departure. Defaults to 10. From 1 to 100. Default: `10`.
- Kinds of train (`train_categories`, list): Which trains to list. Leave it empty for long-distance and commuter trains. One or more of: `Long-distance` (Long-distance trains), `Commuter` (Commuter trains), `Cargo` (Freight trains).

**Outputs**

- `count` (number): How many trains are listed
- `date` (text): The date asked for, YYYY-MM-DD; empty for the next trains from now
- `from_code` (text): The departure station's short code
- `from_name` (text): The departure station's name
- `matched_count` (number): How many trains run between the two before the limit
- `to_code` (text): The arrival station's short code
- `to_name` (text): The arrival station's name
- `trains` (list): The trains, in order of departure

**Example output**

```json
{
  "count": 2,
  "date": "",
  "from_code": "HKI",
  "from_name": "Helsinki",
  "matched_count": 40,
  "to_code": "TPE",
  "to_name": "Tampere",
  "trains": [
    {
      "arrival_actual": "",
      "arrival_delay_minutes": 0,
      "arrival_estimated": "",
      "arrival_local": "07:58",
      "arrival_time": "2026-10-20T04:58:00Z",
      "arrival_track": "2",
      "cancelled": false,
      "category": "Long-distance",
      "departure_actual": "",
      "departure_date": "2026-10-20",
      "departure_delay_minutes": 0,
      "departure_estimated": "",
      "departure_local": "06:20",
      "departure_time": "2026-10-20T03:20:00Z",
      "departure_track": "8",
      "destination_code": "OL",
      "destination_name": "Oulu",
      "duration_minutes": 98,
      "line": "",
      "operator": "vr",
      "origin_code": "HKI",
      "origin_name": "Helsinki",
      "train_label": "IC 21",
      "train_number": 21,
      "train_type": "IC",
      "train_type_name": "InterCity"
    },
    {
      "arrival_actual": "",
      "arrival_delay_minutes": 0,
      "arrival_estimated": "",
      "arrival_local": "08:53",
      "arrival_time": "2026-10-20T05:53:00Z",
      "arrival_track": "3",
      "cancelled": false,
      "category": "Long-distance",
      "departure_actual": "",
      "departure_date": "2026-10-20",
      "departure_delay_minutes": 0,
      "departure_estimated": "",
      "departure_local": "07:00",
      "departure_time": "2026-10-20T04:00:00Z",
      "departure_track": "10",
      "destination_code": "PM",
      "destination_name": "Pieks\u00e4m\u00e4ki",
      "duration_minutes": 113,
      "line": "",
      "operator": "vr",
      "origin_code": "HKI",
      "origin_name": "Helsinki",
      "train_label": "IC 155",
      "train_number": 155,
      "train_type": "IC",
      "train_type_name": "InterCity"
    }
  ]
}
```

### Get a road traffic message

Get one road traffic message in full by its id: where and when, what is happening, the restrictions, each phase of a roadworks with its working hours, and the traffic centre to contact. The id comes from 'List road traffic messages' or the trigger.

**Inputs**

- Message id (`situation_id`, text, required): The message's id, such as GUID50472522.

**Outputs**

- `additional_information` (text): Further information, in Finnish
- `announcement_type` (text): For an announcement: general, accident report, preliminary accident report, unconfirmed observation, ended or retracted
- `areas` (list): The areas an area-wide message covers
- `comment` (text): The details, in Finnish
- `contact_email` (text): The email address of that traffic centre
- `contact_phone` (text): The phone number of the traffic centre that issued it
- `end_time` (text): When it ends, ISO 8601 in UTC; empty when open-ended
- `features` (list): What is happening, in Finnish, such as Tie on suljettu
- `found` (true/false): False when there is no message with that id
- `latitude` (number): Latitude of where it is; empty for an area-wide message
- `location` (text): Where it is, in Finnish
- `longitude` (number): Longitude of where it is; empty for an area-wide message
- `message_type` (text): traffic_announcements, roadworks, weight_restrictions or exempted_transports
- `municipality` (text): The municipality it is in
- `phases` (list): For roadworks: each phase of the work
- `province` (text): The region it is in
- `released_at` (text): When it was first published, ISO 8601 in UTC
- `restrictions` (list): The restrictions on traffic, such as single lane closed or speed limit 50 km/h
- `road_name` (text): The road's name, such as Kehä III, where it has one
- `road_number` (number): The road it is on; empty for an area-wide message
- `sender` (text): Who issued it
- `severity` (list): For roadworks: how much they affect traffic, such as high
- `situation_id` (text): The message's id, which 'Get a road traffic message' takes
- `start_time` (text): When it starts, ISO 8601 in UTC
- `title` (text): The headline, in Finnish as Fintraffic publishes it
- `updated_at` (text): When it was last updated, ISO 8601 in UTC
- `version` (number): Its version, which rises with each update
- `work_types` (list): For roadworks: the kinds of work, such as resurfacing

**Example output**

```json
{
  "additional_information": "Liikenne- ja kelitiedot verkossa: https://liikennetilanne.fintraffic.fi/",
  "announcement_type": "general",
  "areas": [],
  "comment": "Kiertoreitti ramppien kautta",
  "contact_email": "tampere.liikennekeskus@fintraffic.fi",
  "contact_phone": "02002100",
  "end_time": "",
  "features": [
    "Kuorma on levinnyt tielle",
    "Ajokaistoja suljettu liikenteelt\u00e4"
  ],
  "found": true,
  "latitude": 62.260185,
  "location": "Tie 5 v\u00e4lill\u00e4 Mikkeli - Kuopio, Joroinen. Tarkempi paikka: Kuvansin liittym\u00e4.",
  "longitude": 27.87121,
  "message_type": "traffic_announcements",
  "municipality": "Joroinen",
  "phases": [],
  "province": "Pohjois-Savo",
  "released_at": "2026-10-20T01:52:33Z",
  "restrictions": [],
  "road_name": "",
  "road_number": 5,
  "sender": "Fintraffic Tieliikennekeskus",
  "severity": [],
  "situation_id": "GUID50472522",
  "start_time": "2026-10-20T01:20:00Z",
  "title": "Tie 5, Joroinen. Liikennetiedote. Tilanne jatkuu.",
  "updated_at": "2026-10-20T03:03:00Z",
  "version": 10,
  "work_types": []
}
```

### Get a ship

Get one ship by its MMSI, the radio identity every ship broadcasts: its name, IMO number, kind, size and draught, destination and expected arrival, and its latest position, speed and status with a map link.

**Inputs**

- MMSI (`mmsi`, number, required): The ship's nine-digit MMSI. 'Find ships near a place' and 'List port calls' return it. From 1 to 999999999.

**Outputs**

- `call_sign` (text): Its radio call sign
- `course` (number): Course over ground in degrees
- `destination` (text): Where it says it is going, as its crew typed it
- `details_time` (text): When it last sent its details, ISO 8601 in UTC
- `draught_metres` (number): Its draught in metres
- `eta` (text): When it expects to reach its destination, ISO 8601 in UTC
- `found` (true/false): False when no ship with that MMSI has been seen recently
- `heading` (number): The way its bow points, in degrees; empty when not sent
- `imo` (number): The ship's IMO number; empty for small craft
- `latitude` (number): Latitude
- `length_metres` (number): Its length in metres
- `longitude` (number): Longitude
- `map_url` (text): Its position on OpenStreetMap
- `mmsi` (number): The ship's MMSI, its radio identity, which 'Get a ship' takes
- `name` (text): The ship's name; empty when it has not broadcast one recently
- `navigation_status` (text): Such as Under way using engine, At anchor or Moored
- `position_time` (text): When the position was received, ISO 8601 in UTC
- `ship_type` (text): What kind of ship it is, such as Cargo ship or Passenger ship
- `ship_type_code` (number): The AIS ship type code
- `speed_knots` (number): Speed over ground in knots
- `width_metres` (number): Its width in metres

**Example output**

```json
{
  "call_sign": "OF-3325",
  "course": 337.5,
  "destination": "SUOMENLINNA FERRY",
  "details_time": "2026-10-20T03:01:24Z",
  "draught_metres": 3.2,
  "eta": "2027-04-04T14:00:00Z",
  "found": true,
  "heading": 353,
  "imo": null,
  "latitude": 60.167417,
  "length_metres": 35,
  "longitude": 24.956413,
  "map_url": "https://www.openstreetmap.org/?mlat=60.16742&mlon=24.95641#map=13/60.16742/24.95641",
  "mmsi": 230108610,
  "name": "SUOKKI",
  "navigation_status": "Moored",
  "position_time": "2026-10-20T03:09:37Z",
  "ship_type": "Passenger ship",
  "ship_type_code": 60,
  "speed_knots": 0.0,
  "width_metres": 9
}
```

### Get a station's departures and arrivals

Get the next trains leaving or arriving at a Finnish railway station, like the departure board: the time, the train and where it is going, the track, and whether it is on time, late or cancelled, with the official reason for a delay. Use it for a morning commute message, a station display or an alert.

**Inputs**

- Station (`station`, text, required): The station. Pick it from the list, or type its name or short code (HKI is Helsinki).
- Show (`show`, text): Departures, arrivals, or both together in time order. One of: `departures`, `arrivals`, `both` (Departures and arrivals). Default: `departures`.
- How many trains (`how_many`, number): How many departures, and how many arrivals, to list. Defaults to 10. From 1 to 50. Default: `10`.
- Kinds of train (`train_categories`, list): Which trains to list. Leave it empty for long-distance and commuter trains, the ones passengers can take. One or more of: `Long-distance` (Long-distance trains), `Commuter` (Commuter trains), `Cargo` (Freight trains).

**Outputs**

- `cancelled_count` (number): How many of them are cancelled
- `count` (number): How many calls are listed
- `delayed_count` (number): How many of them are running late
- `show` (text): departures, arrivals or both
- `station_code` (text): The station's short code
- `station_name` (text): The station's name
- `trains` (list): The coming departures and arrivals, in timetable order

**Example output**

```json
{
  "cancelled_count": 0,
  "count": 2,
  "delayed_count": 1,
  "show": "departures",
  "station_code": "HKI",
  "station_name": "Helsinki",
  "trains": [
    {
      "actual_time": "",
      "cancelled": false,
      "category": "Commuter",
      "causes": [],
      "delay_minutes": 0,
      "departure_date": "2026-10-20",
      "destination_code": "HKI",
      "destination_name": "Helsinki",
      "estimated_time": "",
      "expected_local": "06:16",
      "is_running": false,
      "kind": "departure",
      "line": "I",
      "operator": "vr",
      "origin_code": "HKI",
      "origin_name": "Helsinki",
      "scheduled_local": "06:16",
      "scheduled_time": "2026-10-20T03:16:00Z",
      "track": "2",
      "train_label": "I train",
      "train_number": 8817,
      "train_type": "HL",
      "train_type_name": "Commuter train"
    },
    {
      "actual_time": "",
      "cancelled": false,
      "category": "Commuter",
      "causes": [
        "Waiting for a crossing, a train ahead or an overtaking (L2)"
      ],
      "delay_minutes": 4,
      "departure_date": "2026-10-20",
      "destination_code": "KLH",
      "destination_name": "Kauklahti",
      "estimated_time": "2026-10-20T03:21:00Z",
      "expected_local": "06:21",
      "is_running": false,
      "kind": "departure",
      "line": "E",
      "operator": "vr",
      "origin_code": "HKI",
      "origin_name": "Helsinki",
      "scheduled_local": "06:17",
      "scheduled_time": "2026-10-20T03:17:00Z",
      "track": "14",
      "train_label": "E train",
      "train_number": 8311,
      "train_type": "HL",
      "train_type_name": "Commuter train"
    }
  ]
}
```

### Get a train's carriages

See how a train is made up: its locomotives, each carriage in order with the car number printed on tickets, and which cars have the restaurant, the play area, the pet space or wheelchair spaces, leg by leg. Use it to tell a traveller which car to head for.

**Inputs**

- Train number (`train_number`, number, required): The train's number, as on the ticket and the departure boards: 162 for IC 162. Every station list and route search returns it. From 1 to 999999.
- Departure date (`departure_date`, date): The day the train leaves its first station. Leave it empty for today in Finland. A night train that left yesterday evening is yesterday's.

**Outputs**

- `carriage_count` (number): The most carriages it runs with on any leg
- `category` (text): Long-distance, Commuter or Cargo
- `departure_date` (text): The departure date, YYYY-MM-DD
- `features` (list): What the train has on board, such as Restaurant or cafe
- `found` (true/false): False when Fintraffic has no carriage list for that train and date
- `operator` (text): The operator's short code
- `section_count` (number): How many legs the composition is given for
- `sections` (list): Each leg of the journey and the train that runs it
- `train_label` (text): How the train is signed, such as IC 162
- `train_number` (number): The train number
- `train_type` (text): Fintraffic's train type code

**Example output**

```json
{
  "carriage_count": 4,
  "category": "Long-distance",
  "departure_date": "2026-10-20",
  "features": [
    "Pets allowed",
    "Restaurant or cafe",
    "Play area for children",
    "Wheelchair space"
  ],
  "found": true,
  "operator": "vr",
  "section_count": 1,
  "sections": [
    {
      "carriage_count": 4,
      "carriages": [
        {
          "carriage_number": 1,
          "features": [
            "Pets allowed"
          ],
          "length_metres": 27.4,
          "position": 1,
          "type": "Edo"
        },
        {
          "carriage_number": 2,
          "features": [],
          "length_metres": 26.4,
          "position": 2,
          "type": "CEd"
        },
        {
          "carriage_number": 3,
          "features": [
            "Restaurant or cafe"
          ],
          "length_metres": 26.4,
          "position": 3,
          "type": "ERd"
        },
        {
          "carriage_number": 4,
          "features": [
            "Play area for children",
            "Wheelchair space"
          ],
          "length_metres": 26.4,
          "position": 4,
          "type": "Edfs"
        }
      ],
      "from_code": "TPE",
      "from_name": "Tampere",
      "length_metres": 126,
      "locomotives": [
        {
          "position": 5,
          "power": "Electric",
          "type": "Sr3"
        }
      ],
      "maximum_speed": 200,
      "to_code": "HKI",
      "to_name": "Helsinki"
    }
  ],
  "train_label": "IC 162",
  "train_number": 162,
  "train_type": "IC"
}
```

### Get a train's location

Find where a running train is right now: its GPS position, speed, the nearest station and a map link. A train that is not running comes back as not found.

**Inputs**

- Train number (`train_number`, number, required): The train's number, as on the ticket and the departure boards: 162 for IC 162. Every station list and route search returns it. From 1 to 999999.

**Outputs**

- `departure_date` (text): The departure date of the run it is on
- `found` (true/false): False when the train is not running now
- `is_gps` (true/false): True when the position came from GPS
- `latitude` (number): Latitude of its last reported position
- `longitude` (number): Longitude of its last reported position
- `map_url` (text): The position on OpenStreetMap
- `nearest_station_code` (text): The nearest passenger station's short code
- `nearest_station_km` (number): How far that station is, in km
- `nearest_station_name` (text): The nearest passenger station's name
- `recorded_at` (text): When the position was recorded, ISO 8601 in UTC
- `speed_kmh` (number): Its speed in km/h
- `train_number` (number): The train number

**Example output**

```json
{
  "departure_date": "2026-10-20",
  "found": true,
  "is_gps": true,
  "latitude": 61.151187,
  "longitude": 23.956642,
  "map_url": "https://www.openstreetmap.org/?mlat=61.15119&mlon=23.95664#map=13/61.15119/23.95664",
  "nearest_station_code": "TL",
  "nearest_station_km": 5.6,
  "nearest_station_name": "Toijala",
  "recorded_at": "2026-10-20T03:11:29Z",
  "speed_kmh": 160,
  "train_number": 162
}
```

### Get a train's timetable and delays

Follow one train by its number: every station it calls at with the timetabled, estimated and actual times, the track, how late it is now, where it last stopped and stops next, and why it is late. A train that does not run that day comes back as not found rather than as an error.

**Inputs**

- Train number (`train_number`, number, required): The train's number, as on the ticket and the departure boards: 162 for IC 162. Every station list and route search returns it. From 1 to 999999.
- Departure date (`departure_date`, date): The day the train leaves its first station. Leave it empty for today in Finland. A night train that left yesterday evening is yesterday's.
- Include stations it passes through (`every_stop`, true/false): Also list the stations the train passes without stopping, and its stops that are not for passengers. Default: `false`.

**Outputs**

- `cancelled` (true/false): True when the whole train is cancelled
- `category` (text): Long-distance, Commuter or Cargo
- `causes` (list): Every delay cause recorded for the train, in English
- `delay_minutes` (number): The latest known delay in minutes: the last recorded one, else the first estimate
- `departure_date` (text): The date the train leaves its first station, YYYY-MM-DD in Finnish time
- `destination_code` (text): The short code of the station the train ends at
- `destination_name` (text): The name of the station the train ends at
- `found` (true/false): False when no train with that number runs on that date
- `is_running` (true/false): True when the train is on its way now
- `last_station_code` (text): Where it last called; empty before it sets off
- `last_station_name` (text): The name of the station it last called at
- `line` (text): The commuter line letter, such as K or P; empty for other trains
- `next_station_code` (text): Where it calls next; empty once it has arrived
- `next_station_name` (text): The name of the station it calls at next
- `operator` (text): The operator's short code, such as vr
- `origin_code` (text): The short code of the station the train starts from
- `origin_name` (text): The name of the station the train starts from
- `stop_count` (number): How many stops are listed
- `stops` (list): The stations it calls at, in order
- `train_label` (text): How the train is signed: IC 162, or K train for a commuter line
- `train_number` (number): The train number, unique within its departure date
- `train_type` (text): Fintraffic's train type code, such as IC, S or HL
- `train_type_name` (text): The train type in words, such as InterCity or Pendolino; empty for uncommon types

**Example output**

```json
{
  "cancelled": false,
  "category": "Long-distance",
  "causes": [],
  "delay_minutes": 1,
  "departure_date": "2026-10-20",
  "destination_code": "HKI",
  "destination_name": "Helsinki",
  "found": true,
  "is_running": true,
  "last_station_code": "TL",
  "last_station_name": "Toijala",
  "line": "",
  "next_station_code": "HL",
  "next_station_name": "H\u00e4meenlinna",
  "operator": "vr",
  "origin_code": "TPE",
  "origin_name": "Tampere",
  "stop_count": 8,
  "stops": [
    {
      "arrival_actual": "",
      "arrival_estimated": "",
      "arrival_time": "",
      "cancelled": false,
      "causes": [],
      "delay_minutes": 1,
      "departure_actual": "2026-10-20T02:45:49Z",
      "departure_estimated": "",
      "departure_time": "2026-10-20T02:45:00Z",
      "passed": true,
      "station_code": "TPE",
      "station_name": "Tampere",
      "stops": true,
      "track": "1"
    },
    {
      "arrival_actual": "2026-10-20T02:56:52Z",
      "arrival_estimated": "",
      "arrival_time": "2026-10-20T02:56:00Z",
      "cancelled": false,
      "causes": [],
      "delay_minutes": 1,
      "departure_actual": "2026-10-20T02:58:14Z",
      "departure_estimated": "",
      "departure_time": "2026-10-20T02:57:00Z",
      "passed": true,
      "station_code": "LP\u00c4",
      "station_name": "Lemp\u00e4\u00e4l\u00e4",
      "stops": true,
      "track": "1"
    },
    {
      "arrival_actual": "2026-10-20T03:06:39Z",
      "arrival_estimated": "",
      "arrival_time": "2026-10-20T03:06:00Z",
      "cancelled": false,
      "causes": [],
      "delay_minutes": 1,
      "departure_actual": "2026-10-20T03:08:18Z",
      "departure_estimated": "",
      "departure_time": "2026-10-20T03:07:00Z",
      "passed": true,
      "station_code": "TL",
      "station_name": "Toijala",
      "stops": true,
      "track": "3"
    }
  ],
  "train_label": "IC 162",
  "train_number": 162,
  "train_type": "IC",
  "train_type_name": "InterCity"
}
```

### Get road condition forecast

Get Fintraffic's road condition forecast for a main road, section by section: the surface now and in 2, 4, 6 and 12 hours (dry, wet, frost, ice, snow), the road temperature, and whether driving conditions are poor. Use it to warn before a drive or a delivery run.

**Inputs**

- Road (`road`, text, required): The road. Fintraffic forecasts the main roads in the list; you can also give the road number.

**Outputs**

- `poor_section_count` (number): How many sections have poor driving conditions now or ahead
- `road_number` (number): The road
- `section_count` (number): How many sections of the road are forecast
- `sections` (list): Each section of the road, in order
- `updated_at` (text): When the forecast was made, ISO 8601 in UTC

**Example output**

```json
{
  "poor_section_count": 0,
  "road_number": 4,
  "section_count": 2,
  "sections": [
    {
      "description": "Vt 4: Helsinki - Keh\u00e4 I",
      "forecasts": [
        {
          "air_temperature": 3.7,
          "daylight": false,
          "hours_ahead": 0,
          "is_observation": true,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": 0.9,
          "time": "2026-10-20T03:00:00Z",
          "wind_speed": 2.9
        },
        {
          "air_temperature": 3.4,
          "daylight": false,
          "hours_ahead": 2,
          "is_observation": false,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": 1.0,
          "time": "2026-10-20T05:00:00Z",
          "wind_speed": 2.9
        },
        {
          "air_temperature": 5.4,
          "daylight": true,
          "hours_ahead": 4,
          "is_observation": false,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": 4.2,
          "time": "2026-10-20T07:00:00Z",
          "wind_speed": 3.1
        }
      ],
      "poor_condition_ahead": false,
      "section_id": "00004_101_000_0"
    },
    {
      "description": "Vt 4: Keh\u00e4 I - J\u00e4rvenp\u00e4\u00e4",
      "forecasts": [
        {
          "air_temperature": 0.2,
          "daylight": false,
          "hours_ahead": 0,
          "is_observation": true,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": -0.7,
          "time": "2026-10-20T03:00:00Z",
          "wind_speed": 1.0
        },
        {
          "air_temperature": 0.2,
          "daylight": false,
          "hours_ahead": 2,
          "is_observation": false,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": -1.0,
          "time": "2026-10-20T05:00:00Z",
          "wind_speed": 1.3
        },
        {
          "air_temperature": 2.4,
          "daylight": true,
          "hours_ahead": 4,
          "is_observation": false,
          "overall_condition": "Normal condition",
          "poor_condition": false,
          "road_condition": "Dry",
          "road_temperature": 2.4,
          "time": "2026-10-20T07:00:00Z",
          "wind_speed": 1.0
        }
      ],
      "poor_condition_ahead": false,
      "section_id": "00004_103_000_0"
    }
  ],
  "updated_at": "2026-10-20T02:45:11Z"
}
```

### Get road weather

Read a roadside weather station: air and road surface temperature, whether the road is dry, wet or icy, the station's own warning, precipitation, wind, visibility and friction, updated every few minutes. Use it to warn drivers or plan winter maintenance.

**Inputs**

- Weather station (`station`, text, required): The road weather station. Pick it from the list, which names each by its road and place, or give its id.

**Outputs**

- `air_temperature` (number): Air temperature in C
- `air_temperature_max_24h` (number): Highest air temperature in the last 24 hours
- `air_temperature_min_24h` (number): Lowest air temperature in the last 24 hours
- `dew_point` (number): Dew point in C
- `friction` (number): Road surface friction, from 0 to 1; empty where not measured
- `humidity` (number): Relative humidity in percent
- `latitude` (number): Latitude
- `longitude` (number): Longitude
- `measured_at` (text): When the readings were taken, ISO 8601 in UTC
- `municipality` (text): The municipality it is in
- `name` (text): The station's name, such as Road 1 Espoo, Nupuri
- `precipitation` (text): Precipitation, such as Dry weather, Drizzle or Snowfall
- `precipitation_intensity` (number): Precipitation intensity in mm an hour
- `province` (text): The region it is in
- `rain_last_24h` (number): Precipitation over the last 24 hours in mm
- `reading_count` (number): How many sensor readings the station sent
- `road_condition` (text): The road surface, such as Dry, Moist, Wet or Frost
- `road_number` (number): The road it stands by
- `road_temperature` (number): Road surface temperature in C
- `station_id` (number): The weather station's id
- `visibility_km` (number): Visibility in km
- `warning` (text): The station's own warning: OK, Beware, Alarm, Frost or Rain
- `wind_direction` (number): Wind direction in degrees
- `wind_direction_compass` (text): Wind direction as a compass point, such as SW
- `wind_gust` (number): Strongest wind over 10 minutes in m/s
- `wind_speed` (number): Average wind speed over 10 minutes in m/s

**Example output**

```json
{
  "air_temperature": -1.2,
  "air_temperature_max_24h": 9.9,
  "air_temperature_min_24h": -1.5,
  "dew_point": -1.4,
  "friction": 0.82,
  "humidity": 99.0,
  "latitude": 60.228227,
  "longitude": 24.596399,
  "measured_at": "2026-10-20T03:08:17Z",
  "municipality": "Espoo",
  "name": "Road 1 Espoo, Nupuri",
  "precipitation": "Dry weather",
  "precipitation_intensity": 0.0,
  "province": "Uusimaa",
  "rain_last_24h": 0.0,
  "reading_count": 95,
  "road_condition": "Dry",
  "road_number": 1,
  "road_temperature": -0.4,
  "station_id": 1001,
  "visibility_km": 8.6,
  "warning": "OK",
  "wind_direction": 283.0,
  "wind_direction_compass": "W",
  "wind_gust": 3.6,
  "wind_speed": 1.8
}
```

### Get traffic volume and speed

Read a traffic counting station: how many vehicles passed in each direction in the last hour and at what average speed, and the rate and speed right now, against the usual free-flowing speed. Slow traffic here means a queue.

**Inputs**

- Counting station (`station`, text, required): The traffic counting station. Pick it from the list, which names each by its road and place, or give its id.

**Outputs**

- `directions` (list): Each direction of travel
- `latitude` (number): Latitude
- `longitude` (number): Longitude
- `measured_at` (text): When the latest reading was taken, ISO 8601 in UTC
- `municipality` (text): The municipality it is in
- `name` (text): The station's name, such as Road 1 Espoo, Nupuri
- `province` (text): The region it is in
- `road_number` (number): The road it stands by
- `station_id` (number): The traffic counter's id
- `total_vehicles_last_hour` (number): Vehicles past in both directions in the last full hour

**Example output**

```json
{
  "directions": [
    {
      "average_speed_last_hour": 111.0,
      "average_speed_now": 116.0,
      "direction": 1,
      "free_flow_speed": 105.0,
      "speed_percent_of_free_flow": 111.0,
      "towards": "Kotka",
      "vehicles_last_hour": 140,
      "vehicles_per_hour_now": 204
    },
    {
      "average_speed_last_hour": 109.0,
      "average_speed_now": 110.0,
      "direction": 2,
      "free_flow_speed": 95.0,
      "speed_percent_of_free_flow": 116.0,
      "towards": "Helsinki",
      "vehicles_last_hour": 236,
      "vehicles_per_hour_now": 564
    }
  ],
  "latitude": 60.417002,
  "longitude": 25.689529,
  "measured_at": "2026-10-20T03:11:11Z",
  "municipality": "Porvoo",
  "name": "Road 7 Porvoo, Rita",
  "province": "Uusimaa",
  "road_number": 7,
  "station_id": 23001,
  "total_vehicles_last_hour": 376
}
```

### Get weather camera pictures

Get the latest pictures from a roadside weather camera, one for each way it looks, with when each was taken. The links are JPEGs refreshed about every ten minutes, ready to post or attach.

**Inputs**

- Camera (`camera`, text, required): The camera. Pick it from the list, which names each by its road and place, or give its id, such as C01503.

**Outputs**

- `camera_id` (text): The camera station's id, such as C01503
- `image_count` (number): How many views the camera has
- `images` (list): The latest picture from each view
- `latitude` (number): Latitude
- `longitude` (number): Longitude
- `municipality` (text): The municipality it is in
- `name` (text): The station's name, such as Road 1 Espoo, Nupuri
- `nearest_weather_station_id` (number): The nearest road weather station, which 'Get road weather' takes
- `province` (text): The region it is in
- `road_number` (number): The road it stands by

**Example output**

```json
{
  "camera_id": "C01503",
  "image_count": 3,
  "images": [
    {
      "direction": "increasing direction",
      "image_url": "https://weathercam.digitraffic.fi/C0150301.jpg",
      "preset_id": "C0150301",
      "resolution": "1280x720",
      "taken_at": "2026-10-20T03:08:08Z",
      "view": "Inkooseen"
    },
    {
      "direction": "decreasing direction",
      "image_url": "https://weathercam.digitraffic.fi/C0150302.jpg",
      "preset_id": "C0150302",
      "resolution": "1280x720",
      "taken_at": "2026-10-20T03:08:34Z",
      "view": "Hankoon"
    },
    {
      "direction": "special direction",
      "image_url": "https://weathercam.digitraffic.fi/C0150309.jpg",
      "preset_id": "C0150309",
      "resolution": "1280x720",
      "taken_at": "2026-10-20T03:08:21Z",
      "view": "Tienpinta"
    }
  ],
  "latitude": 60.05374,
  "longitude": 23.99616,
  "municipality": "Inkoo",
  "name": "Road 51 Inkoo",
  "nearest_weather_station_id": 1013,
  "province": "Uusimaa",
  "road_number": 51
}
```

### List faults in navigation aids

List the reported faults in Finland's buoys, lights, leading marks and other aids to navigation: what is wrong (unlit, missing, off station, damaged), where, and whether it has been fixed. Narrow it to a sea area, watercourse or fairway.

**Inputs**

- Area or fairway (`area_contains`, text): Only faults in a sea area, watercourse or fairway whose name contains this text.
- Only faults not yet fixed (`only_open`, true/false): Leave out faults that have been repaired or were false alarms. Default: `true`.
- How many to return (`limit`, number): How many faults to return, newest first. Defaults to 50. From 1 to 500. Default: `50`.

**Outputs**

- `area_contains` (text): The text the list was narrowed to
- `areas` (list): The sea areas and watercourses the faults are in
- `count` (number): How many faults are listed
- `faults` (list): The faults, newest first
- `matched_count` (number): How many matched before the limit
- `only_open` (true/false): Whether only faults still open were asked for

**Example output**

```json
{
  "area_contains": "",
  "areas": [
    "Archipelago Sea",
    "Bay of Bothnia"
  ],
  "count": 2,
  "faults": [
    {
      "aid_name": "J\u00e4rngrynnan",
      "aid_type": "Ramark",
      "area": "Archipelago Sea",
      "fairway_name": "Ut\u00f6-Hanko-v\u00e4yl\u00e4 (l\u00e4ntinen osa)",
      "fairway_number": 3770,
      "fault_id": -2139921365,
      "fault_type": "Maintenance works",
      "fixed": false,
      "fixed_at": "",
      "latitude": 59.8948302666,
      "longitude": 22.4626750072,
      "reported_at": "2026-08-31T20:21:10Z",
      "state": "Open"
    },
    {
      "aid_name": "Lehm\u00e4saari ylempi",
      "aid_type": "Leading mark",
      "area": "Gulf of Finland",
      "fairway_name": "Kirkonmaan venereitti",
      "fairway_number": 5717,
      "fault_id": -2139921428,
      "fault_type": "Limited visibility",
      "fixed": false,
      "fixed_at": "",
      "latitude": 60.4204026635,
      "longitude": 26.9903290274,
      "reported_at": "2026-08-20T18:43:17Z",
      "state": "Open"
    }
  ],
  "matched_count": 51,
  "only_open": true
}
```

### List port calls

List the ships calling at a Finnish port: the ones expected to arrive or leave in the coming hours, or the ones that arrived or left recently, with the times, harbour and berth, where they come from and go next, and their agent.

**Inputs**

- Port (`port`, text, required): The port. Pick it from the list, or give its five-letter code, such as FIHEL for Helsinki.
- Which ships (`which`, text): Arrivals or departures, coming up or just happened. One of: `expected_arrivals` (Ships expected to arrive), `expected_departures` (Ships expected to leave), `recent_arrivals` (Ships that have arrived), `recent_departures` (Ships that have left). Default: `expected_arrivals`.
- Hours (`hours`, number): How many hours ahead, or back, to look. Defaults to 24. From 1 to 168. Default: `24`.
- How many to return (`limit`, number): How many port calls to return. Defaults to 25. From 1 to 200. Default: `25`.

**Outputs**

- `count` (number): How many port calls are listed
- `from_time` (text): Start of the time window, ISO 8601 in UTC
- `matched_count` (number): How many fell in the window before the limit
- `port_calls` (list): The port calls, in time order
- `port_code` (text): The port's UN/LOCODE, such as FIHEL
- `port_name` (text): The port's name
- `to_time` (text): End of the time window, ISO 8601 in UTC
- `which` (text): expected_arrivals, expected_departures, recent_arrivals or recent_departures

**Example output**

```json
{
  "count": 2,
  "from_time": "2026-10-20T03:20:08Z",
  "matched_count": 23,
  "port_calls": [
    {
      "agent": "C & C Port Agency Finland Oy Ltd, Helsinki",
      "ata": "2026-10-20T02:00:00Z",
      "atd": "",
      "berth": "VDC",
      "call_sign": "CQBN",
      "crew": 13,
      "eta": "2026-10-20T03:15:00Z",
      "etd": "2026-10-20T14:30:00Z",
      "imo": 9328041,
      "mmsi": 305033000,
      "nationality": "PT",
      "next_port": "LVRIX",
      "passengers": null,
      "port_area": "Vuosaaren satama",
      "port_call_id": 3406212,
      "previous_port": "NLRTM",
      "vessel_name": "Mirror",
      "vessel_type": "container ship"
    },
    {
      "agent": "Finnlines Oyj",
      "ata": "",
      "atd": "",
      "berth": "VE1",
      "call_sign": "OJTP",
      "crew": 27,
      "eta": "2026-10-20T05:00:00Z",
      "etd": "2026-10-20T19:30:00Z",
      "imo": 9856842,
      "mmsi": 230697000,
      "nationality": "FI",
      "next_port": "FIKTK",
      "passengers": 1,
      "port_area": "Vuosaaren satama",
      "port_call_id": 3377945,
      "previous_port": "FIHKO",
      "vessel_name": "Finneco II",
      "vessel_type": "roro"
    }
  ],
  "port_code": "FIHEL",
  "port_name": "Helsinki (Helsingfors)",
  "to_time": "2026-10-21T03:20:08Z",
  "which": "expected_arrivals"
}
```

### List railway stations

List Finland's railway stations with their short codes and coordinates, narrowed by name. Use it to turn a place name into the code the other rail actions take, or to map stations.

**Inputs**

- Name contains (`name_contains`, text): Only stations whose name contains this text.
- Only passenger stations (`passenger_only`, true/false): Leave out stations where no passenger train stops, such as freight yards. Default: `true`.
- How many to return (`limit`, number): How many stations to return, in alphabetical order. Defaults to 100. From 1 to 600. Default: `100`.

**Outputs**

- `count` (number): How many stations are listed
- `matched_count` (number): How many matched before the limit
- `name_contains` (text): The text names were narrowed to
- `passenger_only` (true/false): Whether only passenger stations were asked for
- `stations` (list): The stations, in alphabetical order

**Example output**

```json
{
  "count": 2,
  "matched_count": 2,
  "name_contains": "hel",
  "passenger_only": true,
  "stations": [
    {
      "code": "HKI",
      "country": "FI",
      "latitude": 60.171356,
      "longitude": 24.941444,
      "name": "Helsinki",
      "official_name": "Helsinki asema",
      "passenger_traffic": true,
      "type": "station",
      "uic_code": 1
    },
    {
      "code": "LOH",
      "country": "FI",
      "latitude": 60.270798,
      "longitude": 24.853299,
      "name": "Louhela",
      "official_name": "Louhela",
      "passenger_traffic": true,
      "type": "stopping point",
      "uic_code": 661
    }
  ]
}
```

### List road traffic messages

List the current messages from Finland's road traffic centre: traffic announcements (accidents, closures, poor driving conditions), roadworks, weight restrictions or exempted transports, newest first, optionally on one road or in one municipality. Titles and details are in Finnish, as Fintraffic publishes them.

**Inputs**

- Kind of message (`message_type`, text): Which messages to list. Leave it empty for traffic announcements. Weight restrictions are only issued during the spring thaw.
- Road number (`road_number`, number): Only messages about this road, such as 4 for road 4. From 1 to 99999.
- Municipality (`municipality`, text): Only messages in this municipality or area. Capitals and accents do not matter.
- How many to return (`limit`, number): How many messages to return. Defaults to 25. From 1 to 500. Default: `25`.

**Outputs**

- `count` (number): How many messages are listed
- `matched_count` (number): How many matched before the limit
- `message_type` (text): The kind of message listed
- `message_type_name` (text): The kind of message in words
- `messages` (list): The messages, newest first
- `municipality` (text): The place the list was narrowed to; empty when not
- `road_number` (number): The road the list was narrowed to; empty when not
- `total_count` (number): How many of this kind are current in all of Finland

**Example output**

```json
{
  "count": 2,
  "matched_count": 9,
  "message_type": "roadworks",
  "message_type_name": "Roadworks",
  "messages": [
    {
      "announcement_type": "",
      "areas": [],
      "comment": "",
      "end_time": "2026-10-20T20:59:59Z",
      "features": [],
      "latitude": 61.532488,
      "location": "Tie 9 v\u00e4lill\u00e4 Tampere - Jyv\u00e4skyl\u00e4, Tampere. Tarkempi paikka: Aitovuoren liittym\u00e4.",
      "longitude": 23.95157,
      "message_type": "roadworks",
      "municipality": "Tampere",
      "province": "Pirkanmaa",
      "released_at": "2026-10-19T18:05:48Z",
      "restrictions": [
        "slow moving maintenance vehicle"
      ],
      "road_name": "",
      "road_number": 9,
      "severity": [
        "high"
      ],
      "situation_id": "GUID50472516",
      "start_time": "2026-10-18T21:00:00Z",
      "title": "Tie 9, Tampere. Tiety\u00f6.",
      "updated_at": "2026-10-19T18:05:48Z",
      "version": 1,
      "work_types": [
        "resurfacing"
      ]
    },
    {
      "announcement_type": "",
      "areas": [],
      "comment": "",
      "end_time": "2026-10-22T20:59:59Z",
      "features": [
        "Nopeusrajoitus",
        "Ajokaista suljettu liikenteelt\u00e4"
      ],
      "latitude": 62.634954,
      "location": "Tie 9 v\u00e4lill\u00e4 Kuopio - Joensuu, Liperi. Tarkempi paikka: Paikasta Viinij\u00e4rven kirkonkyl\u00e4 3,9 km, vaikutusalue 4,5 km, suuntaan Kuorinka.",
      "longitude": 29.300183,
      "message_type": "roadworks",
      "municipality": "Liperi",
      "province": "Pohjois-Karjala",
      "released_at": "2026-10-17T07:13:16Z",
      "restrictions": [
        "single lane closed",
        "speed limit 80 km/h"
      ],
      "road_name": "",
      "road_number": 9,
      "severity": [
        "high"
      ],
      "situation_id": "GUID50472429",
      "start_time": "2026-10-19T21:00:00Z",
      "title": "Tie 9, Liperi. Tiety\u00f6.",
      "updated_at": "2026-10-17T07:13:16Z",
      "version": 1,
      "work_types": [
        "other"
      ]
    }
  ],
  "municipality": "",
  "road_number": 9,
  "total_count": 503
}
```

### List station announcements

List the announcements currently shown on station screens and read out over the speakers: replacement buses, the reason a train is late, track work notices and changes on board, in English, Finnish or Swedish. Narrow it to one station or one train.

**Inputs**

- Station (`station`, text): Only announcements for this station. Leave it empty for every station.
- Train number (`train_number`, number): Only announcements about this train. From 1 to 999999.
- Only general notices (`only_station_notices`, true/false): Leave out announcements about a particular train and keep the general ones, such as track work notices. Default: `false`.
- Language (`language`, text): The language of the announcement texts. One of: `en` (English), `fi` (Finnish), `sv` (Swedish). Default: `en`.

**Outputs**

- `announcements` (list): The announcements, newest first
- `count` (number): How many announcements are listed
- `language` (text): The language the texts are in: en, fi or sv
- `station_code` (text): The station asked about; empty for all of them
- `station_name` (text): Its name
- `station_notice_count` (number): How many are general notices for stations
- `train_count` (number): How many are about a particular train
- `train_number` (number): The train asked about; empty for all of them

**Example output**

```json
{
  "announcements": [
    {
      "created_at": "2026-10-19T18:21:00Z",
      "id": "MVM20261019182119898",
      "shown_on_screens": true,
      "spoken": false,
      "station_codes": [
        "KEM",
        "TRV"
      ],
      "station_names": [
        "Kemi",
        "Tervola"
      ],
      "text": "Reason for the delay: other train services.",
      "train_departure_date": "2026-10-19",
      "train_number": 27,
      "valid_from": "2026-10-19T18:21:00Z",
      "valid_until": "2026-10-21T00:00:00Z",
      "version": 1
    },
    {
      "created_at": "2026-09-28T17:19:00Z",
      "id": "SHM20260429110185452",
      "shown_on_screens": true,
      "spoken": false,
      "station_codes": [
        "KR"
      ],
      "station_names": [
        "Karjaa"
      ],
      "text": "Trackworks: 3\u20134 October Long distance trains will be replaced by buses between Kirkkonummi and Helsinki. From 4.00 am on 3 October to 4.00 am on 4 October, commuter train services will be replaced by buses between Kirkkonummi and Lepp\u00e4vaara A - trains between Lepp\u00e4vaara - Helsinki and H- trains between Kirkkonummi - Siuntio - Hanko are operating.",
      "train_departure_date": "",
      "train_number": null,
      "valid_from": "2026-08-27T21:00:00Z",
      "valid_until": "2026-10-31T21:59:00Z",
      "version": 18
    }
  ],
  "count": 2,
  "language": "en",
  "station_code": "",
  "station_name": "",
  "station_notice_count": 1,
  "train_count": 1,
  "train_number": null
}
```
