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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get a train's location | Find where a running train is right now: its GPS position, speed, the nearest station and a map link. |
| 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. |
| 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. |
| 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. |
| 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. |
| Get weather camera pictures | Get the latest pictures from a roadside weather camera, one for each way it looks, with when each was taken. |
| 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. |
| 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. |
| List railway stations | List Finland's railway stations with their short codes and coordinates, narrowed by name. |
| 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. |
| 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. |
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
latitudenumberRequired - Latitude of the point, such as 60.1675 for Helsinki.From -90 to 90.
- Longitude
longitudenumberRequired - Longitude of the point, such as 24.95 for Helsinki.From -180 to 180.
- Radius in km
radius_kmnumber - How far around the point to look. Defaults to 5 km.From 0.1 to 50. Default:
5. - Only moving ships
moving_onlytrue/false - Leave out ships that are moored, anchored or stopped.Default:
false. - How many to return
limitnumber - 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
- From
from_stationtextRequired - The station to leave from: pick it, or type its name or short code.
- To
to_stationtextRequired - The station to travel to: pick it, or type its name or short code.
- Date
datedate - The day to travel. Leave it empty for the next trains from now.
- How many trains
how_manynumber - How many trains to list, in order of departure. Defaults to 10.From 1 to 100. Default:
10. - Kinds of train
train_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 id
situation_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
- MMSI
mmsinumberRequired - 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
- Station
stationtextRequired - The station. Pick it from the list, or type its name or short code (HKI is Helsinki).
- Show
showtext - Departures, arrivals, or both together in time order.One of:
departures,arrivals,both(Departures and arrivals). Default:departures. - How many trains
how_manynumber - How many departures, and how many arrivals, to list. Defaults to 10.From 1 to 50. Default:
10. - Kinds of train
train_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 number
train_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 date
departure_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 number
train_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 number
train_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 date
departure_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 through
every_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
- Road
roadtextRequired - 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 station
stationtextRequired - 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 station
stationtextRequired - 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
- Camera
cameratextRequired - 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 fairway
area_containstext - Only faults in a sea area, watercourse or fairway whose name contains this text.
- Only faults not yet fixed
only_opentrue/false - Leave out faults that have been repaired or were false alarms.Default:
true. - How many to return
limitnumber - 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
- Port
porttextRequired - The port. Pick it from the list, or give its five-letter code, such as FIHEL for Helsinki.
- Which ships
whichtext - 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
hoursnumber - How many hours ahead, or back, to look. Defaults to 24.From 1 to 168. Default:
24. - How many to return
limitnumber - 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 contains
name_containstext - Only stations whose name contains this text.
- Only passenger stations
passenger_onlytrue/false - Leave out stations where no passenger train stops, such as freight yards.Default:
true. - How many to return
limitnumber - 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 message
message_typetext - Which messages to list. Leave it empty for traffic announcements. Weight restrictions are only issued during the spring thaw.
- Road number
road_numbernumber - Only messages about this road, such as 4 for road 4.From 1 to 99999.
- Municipality
municipalitytext - Only messages in this municipality or area. Capitals and accents do not matter.
- How many to return
limitnumber - 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
- Station
stationtext - Only announcements for this station. Leave it empty for every station.
- Train number
train_numbernumber - Only announcements about this train.From 1 to 999999.
- Only general notices
only_station_noticestrue/false - Leave out announcements about a particular train and keep the general ones, such as track work notices.Default:
false. - Language
languagetext - 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
}