Digitraffic

App · 17 actions

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.

Actions

ActionWhat it does
Find ships near a placeFind 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.
Find trains between two stationsFind 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.
Get a road traffic messageGet 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.
Get a shipGet 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.
Get a station's departures and arrivalsGet 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.
Get a train's carriagesSee 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.
Get a train's locationFind where a running train is right now: its GPS position, speed, the nearest station and a map link.
Get a train's timetable and delaysFollow 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.
Get road condition forecastGet 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.
Get road weatherRead 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.
Get traffic volume and speedRead 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.
Get weather camera picturesGet the latest pictures from a roadside weather camera, one for each way it looks, with when each was taken.
List faults in navigation aidsList 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.
List port callsList 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.
List railway stationsList Finland's railway stations with their short codes and coordinates, narrowed by name.
List road traffic messagesList 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.
List station announcementsList 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.

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

LatitudelatitudenumberRequired
Latitude of the point, such as 60.1675 for Helsinki.From -90 to 90.
LongitudelongitudenumberRequired
Longitude of the point, such as 24.95 for Helsinki.From -180 to 180.
Radius in kmradius_kmnumber
How far around the point to look. Defaults to 5 km.From 0.1 to 50. Default: 5.
Only moving shipsmoving_onlytrue/false
Leave out ships that are moored, anchored or stopped.Default: false.
How many to returnlimitnumber
How many ships to return, nearest first. Defaults to 25.From 1 to 200. Default: 25.

Outputs

countnumber
How many ships are listed
latitudenumber
The latitude searched around
longitudenumber
The longitude searched around
matched_countnumber
How many were found before the limit
moving_countnumber
How many of them are moving
radius_kmnumber
The search radius in km
shipslist
The ships, nearest first
Example output
{
  "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

Fromfrom_stationtextRequired
The station to leave from: pick it, or type its name or short code.
Toto_stationtextRequired
The station to travel to: pick it, or type its name or short code.
Datedatedate
The day to travel. Leave it empty for the next trains from now.
How many trainshow_manynumber
How many trains to list, in order of departure. Defaults to 10.From 1 to 100. Default: 10.
Kinds of traintrain_categorieslist
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

countnumber
How many trains are listed
datetext
The date asked for, YYYY-MM-DD; empty for the next trains from now
from_codetext
The departure station's short code
from_nametext
The departure station's name
matched_countnumber
How many trains run between the two before the limit
to_codetext
The arrival station's short code
to_nametext
The arrival station's name
trainslist
The trains, in order of departure
Example output
{
  "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 idsituation_idtextRequired
The message's id, such as GUID50472522.

Outputs

additional_informationtext
Further information, in Finnish
announcement_typetext
For an announcement: general, accident report, preliminary accident report, unconfirmed observation, ended or retracted
areaslist
The areas an area-wide message covers
commenttext
The details, in Finnish
contact_emailtext
The email address of that traffic centre
contact_phonetext
The phone number of the traffic centre that issued it
end_timetext
When it ends, ISO 8601 in UTC; empty when open-ended
featureslist
What is happening, in Finnish, such as Tie on suljettu
foundtrue/false
False when there is no message with that id
latitudenumber
Latitude of where it is; empty for an area-wide message
locationtext
Where it is, in Finnish
longitudenumber
Longitude of where it is; empty for an area-wide message
message_typetext
traffic_announcements, roadworks, weight_restrictions or exempted_transports
municipalitytext
The municipality it is in
phaseslist
For roadworks: each phase of the work
provincetext
The region it is in
released_attext
When it was first published, ISO 8601 in UTC
restrictionslist
The restrictions on traffic, such as single lane closed or speed limit 50 km/h
road_nametext
The road's name, such as Kehä III, where it has one
road_numbernumber
The road it is on; empty for an area-wide message
sendertext
Who issued it
severitylist
For roadworks: how much they affect traffic, such as high
situation_idtext
The message's id, which 'Get a road traffic message' takes
start_timetext
When it starts, ISO 8601 in UTC
titletext
The headline, in Finnish as Fintraffic publishes it
updated_attext
When it was last updated, ISO 8601 in UTC
versionnumber
Its version, which rises with each update
work_typeslist
For roadworks: the kinds of work, such as resurfacing
Example output
{
  "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

MMSImmsinumberRequired
The ship's nine-digit MMSI. 'Find ships near a place' and 'List port calls' return it.From 1 to 999999999.

Outputs

call_signtext
Its radio call sign
coursenumber
Course over ground in degrees
destinationtext
Where it says it is going, as its crew typed it
details_timetext
When it last sent its details, ISO 8601 in UTC
draught_metresnumber
Its draught in metres
etatext
When it expects to reach its destination, ISO 8601 in UTC
foundtrue/false
False when no ship with that MMSI has been seen recently
headingnumber
The way its bow points, in degrees; empty when not sent
imonumber
The ship's IMO number; empty for small craft
latitudenumber
Latitude
length_metresnumber
Its length in metres
longitudenumber
Longitude
map_urltext
Its position on OpenStreetMap
mmsinumber
The ship's MMSI, its radio identity, which 'Get a ship' takes
nametext
The ship's name; empty when it has not broadcast one recently
navigation_statustext
Such as Under way using engine, At anchor or Moored
position_timetext
When the position was received, ISO 8601 in UTC
ship_typetext
What kind of ship it is, such as Cargo ship or Passenger ship
ship_type_codenumber
The AIS ship type code
speed_knotsnumber
Speed over ground in knots
width_metresnumber
Its width in metres
Example output
{
  "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

StationstationtextRequired
The station. Pick it from the list, or type its name or short code (HKI is Helsinki).
Showshowtext
Departures, arrivals, or both together in time order.One of: departures, arrivals, both (Departures and arrivals). Default: departures.
How many trainshow_manynumber
How many departures, and how many arrivals, to list. Defaults to 10.From 1 to 50. Default: 10.
Kinds of traintrain_categorieslist
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_countnumber
How many of them are cancelled
countnumber
How many calls are listed
delayed_countnumber
How many of them are running late
showtext
departures, arrivals or both
station_codetext
The station's short code
station_nametext
The station's name
trainslist
The coming departures and arrivals, in timetable order
Example output
{
  "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 numbertrain_numbernumberRequired
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 datedeparture_datedate
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_countnumber
The most carriages it runs with on any leg
categorytext
Long-distance, Commuter or Cargo
departure_datetext
The departure date, YYYY-MM-DD
featureslist
What the train has on board, such as Restaurant or cafe
foundtrue/false
False when Fintraffic has no carriage list for that train and date
operatortext
The operator's short code
section_countnumber
How many legs the composition is given for
sectionslist
Each leg of the journey and the train that runs it
train_labeltext
How the train is signed, such as IC 162
train_numbernumber
The train number
train_typetext
Fintraffic's train type code
Example output
{
  "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 numbertrain_numbernumberRequired
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_datetext
The departure date of the run it is on
foundtrue/false
False when the train is not running now
is_gpstrue/false
True when the position came from GPS
latitudenumber
Latitude of its last reported position
longitudenumber
Longitude of its last reported position
map_urltext
The position on OpenStreetMap
nearest_station_codetext
The nearest passenger station's short code
nearest_station_kmnumber
How far that station is, in km
nearest_station_nametext
The nearest passenger station's name
recorded_attext
When the position was recorded, ISO 8601 in UTC
speed_kmhnumber
Its speed in km/h
train_numbernumber
The train number
Example output
{
  "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 numbertrain_numbernumberRequired
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 datedeparture_datedate
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 throughevery_stoptrue/false
Also list the stations the train passes without stopping, and its stops that are not for passengers.Default: false.

Outputs

cancelledtrue/false
True when the whole train is cancelled
categorytext
Long-distance, Commuter or Cargo
causeslist
Every delay cause recorded for the train, in English
delay_minutesnumber
The latest known delay in minutes: the last recorded one, else the first estimate
departure_datetext
The date the train leaves its first station, YYYY-MM-DD in Finnish time
destination_codetext
The short code of the station the train ends at
destination_nametext
The name of the station the train ends at
foundtrue/false
False when no train with that number runs on that date
is_runningtrue/false
True when the train is on its way now
last_station_codetext
Where it last called; empty before it sets off
last_station_nametext
The name of the station it last called at
linetext
The commuter line letter, such as K or P; empty for other trains
next_station_codetext
Where it calls next; empty once it has arrived
next_station_nametext
The name of the station it calls at next
operatortext
The operator's short code, such as vr
origin_codetext
The short code of the station the train starts from
origin_nametext
The name of the station the train starts from
stop_countnumber
How many stops are listed
stopslist
The stations it calls at, in order
train_labeltext
How the train is signed: IC 162, or K train for a commuter line
train_numbernumber
The train number, unique within its departure date
train_typetext
Fintraffic's train type code, such as IC, S or HL
train_type_nametext
The train type in words, such as InterCity or Pendolino; empty for uncommon types
Example output
{
  "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

RoadroadtextRequired
The road. Fintraffic forecasts the main roads in the list; you can also give the road number.

Outputs

poor_section_countnumber
How many sections have poor driving conditions now or ahead
road_numbernumber
The road
section_countnumber
How many sections of the road are forecast
sectionslist
Each section of the road, in order
updated_attext
When the forecast was made, ISO 8601 in UTC
Example output
{
  "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 stationstationtextRequired
The road weather station. Pick it from the list, which names each by its road and place, or give its id.

Outputs

air_temperaturenumber
Air temperature in C
air_temperature_max_24hnumber
Highest air temperature in the last 24 hours
air_temperature_min_24hnumber
Lowest air temperature in the last 24 hours
dew_pointnumber
Dew point in C
frictionnumber
Road surface friction, from 0 to 1; empty where not measured
humiditynumber
Relative humidity in percent
latitudenumber
Latitude
longitudenumber
Longitude
measured_attext
When the readings were taken, ISO 8601 in UTC
municipalitytext
The municipality it is in
nametext
The station's name, such as Road 1 Espoo, Nupuri
precipitationtext
Precipitation, such as Dry weather, Drizzle or Snowfall
precipitation_intensitynumber
Precipitation intensity in mm an hour
provincetext
The region it is in
rain_last_24hnumber
Precipitation over the last 24 hours in mm
reading_countnumber
How many sensor readings the station sent
road_conditiontext
The road surface, such as Dry, Moist, Wet or Frost
road_numbernumber
The road it stands by
road_temperaturenumber
Road surface temperature in C
station_idnumber
The weather station's id
visibility_kmnumber
Visibility in km
warningtext
The station's own warning: OK, Beware, Alarm, Frost or Rain
wind_directionnumber
Wind direction in degrees
wind_direction_compasstext
Wind direction as a compass point, such as SW
wind_gustnumber
Strongest wind over 10 minutes in m/s
wind_speednumber
Average wind speed over 10 minutes in m/s
Example output
{
  "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 stationstationtextRequired
The traffic counting station. Pick it from the list, which names each by its road and place, or give its id.

Outputs

directionslist
Each direction of travel
latitudenumber
Latitude
longitudenumber
Longitude
measured_attext
When the latest reading was taken, ISO 8601 in UTC
municipalitytext
The municipality it is in
nametext
The station's name, such as Road 1 Espoo, Nupuri
provincetext
The region it is in
road_numbernumber
The road it stands by
station_idnumber
The traffic counter's id
total_vehicles_last_hournumber
Vehicles past in both directions in the last full hour
Example output
{
  "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

CameracameratextRequired
The camera. Pick it from the list, which names each by its road and place, or give its id, such as C01503.

Outputs

camera_idtext
The camera station's id, such as C01503
image_countnumber
How many views the camera has
imageslist
The latest picture from each view
latitudenumber
Latitude
longitudenumber
Longitude
municipalitytext
The municipality it is in
nametext
The station's name, such as Road 1 Espoo, Nupuri
nearest_weather_station_idnumber
The nearest road weather station, which 'Get road weather' takes
provincetext
The region it is in
road_numbernumber
The road it stands by
Example output
{
  "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 fairwayarea_containstext
Only faults in a sea area, watercourse or fairway whose name contains this text.
Only faults not yet fixedonly_opentrue/false
Leave out faults that have been repaired or were false alarms.Default: true.
How many to returnlimitnumber
How many faults to return, newest first. Defaults to 50.From 1 to 500. Default: 50.

Outputs

area_containstext
The text the list was narrowed to
areaslist
The sea areas and watercourses the faults are in
countnumber
How many faults are listed
faultslist
The faults, newest first
matched_countnumber
How many matched before the limit
only_opentrue/false
Whether only faults still open were asked for
Example output
{
  "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

PortporttextRequired
The port. Pick it from the list, or give its five-letter code, such as FIHEL for Helsinki.
Which shipswhichtext
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.
Hourshoursnumber
How many hours ahead, or back, to look. Defaults to 24.From 1 to 168. Default: 24.
How many to returnlimitnumber
How many port calls to return. Defaults to 25.From 1 to 200. Default: 25.

Outputs

countnumber
How many port calls are listed
from_timetext
Start of the time window, ISO 8601 in UTC
matched_countnumber
How many fell in the window before the limit
port_callslist
The port calls, in time order
port_codetext
The port's UN/LOCODE, such as FIHEL
port_nametext
The port's name
to_timetext
End of the time window, ISO 8601 in UTC
whichtext
expected_arrivals, expected_departures, recent_arrivals or recent_departures
Example output
{
  "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 containsname_containstext
Only stations whose name contains this text.
Only passenger stationspassenger_onlytrue/false
Leave out stations where no passenger train stops, such as freight yards.Default: true.
How many to returnlimitnumber
How many stations to return, in alphabetical order. Defaults to 100.From 1 to 600. Default: 100.

Outputs

countnumber
How many stations are listed
matched_countnumber
How many matched before the limit
name_containstext
The text names were narrowed to
passenger_onlytrue/false
Whether only passenger stations were asked for
stationslist
The stations, in alphabetical order
Example output
{
  "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 messagemessage_typetext
Which messages to list. Leave it empty for traffic announcements. Weight restrictions are only issued during the spring thaw.
Road numberroad_numbernumber
Only messages about this road, such as 4 for road 4.From 1 to 99999.
Municipalitymunicipalitytext
Only messages in this municipality or area. Capitals and accents do not matter.
How many to returnlimitnumber
How many messages to return. Defaults to 25.From 1 to 500. Default: 25.

Outputs

countnumber
How many messages are listed
matched_countnumber
How many matched before the limit
message_typetext
The kind of message listed
message_type_nametext
The kind of message in words
messageslist
The messages, newest first
municipalitytext
The place the list was narrowed to; empty when not
road_numbernumber
The road the list was narrowed to; empty when not
total_countnumber
How many of this kind are current in all of Finland
Example output
{
  "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

Stationstationtext
Only announcements for this station. Leave it empty for every station.
Train numbertrain_numbernumber
Only announcements about this train.From 1 to 999999.
Only general noticesonly_station_noticestrue/false
Leave out announcements about a particular train and keep the general ones, such as track work notices.Default: false.
Languagelanguagetext
The language of the announcement texts.One of: en (English), fi (Finnish), sv (Swedish). Default: en.

Outputs

announcementslist
The announcements, newest first
countnumber
How many announcements are listed
languagetext
The language the texts are in: en, fi or sv
station_codetext
The station asked about; empty for all of them
station_nametext
Its name
station_notice_countnumber
How many are general notices for stations
train_countnumber
How many are about a particular train
train_numbernumber
The train asked about; empty for all of them
Example output
{
  "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
}

On this page