What it returns
Live running status of Italian trains from ViaggiaTreno, the official Trenitalia/RFI real-time feed: Frecciarossa, Frecciargento, Intercity and Regionale. Give a train number and get where it is, how late it is, and every stop with scheduled and actual arrival and departure times, delay and the planned and actual platform. Or give a station and get its live departures or arrivals board, the same one shown on the station screens.
Train rows: | field | meaning | |---|---| | train, trainNumber, category | e.g. FR 9600, FR (Frecciarossa), IC, REG | | origin, destination (+ ids) | Terminal stations | | scheduledDeparture, scheduledArrival | Timetable times, Italian time with offset | | status, delayMin | arrived, running, not departed, cancelled; current delay in minutes | | lastSeenStation, lastSeenAt | Where the train was last detected | | notice | Service notice from the operator, if any | | stops | Each stop: scheduled and actual arrival and departure, delays, planned and actual platform, cancelled |
Board rows: station, train, category, destination (departures) or origin (arrivals), scheduled time, delayMin, platformPlanned, platformActual, status.
Common uses
- Travel apps and trip planners showing live delays and platform changes for Italian rail
- Delay-compensation and refund claim tools (actual vs scheduled at each stop)
- Station displays, chatbots and alerts for commuters
Request
POST https://api.pushbuild.com/italy-train-status/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
trainNumbers | list of strings | Train numbers as on the ticket, e.g. 9600 (Frecciarossa), 553 (Intercity), 2001 (Regionale). Up to 50. |
stations | list of strings | Station names for a live board, e.g. Roma Termini, Milano Centrale, Firenze Santa Maria Novella. Up to 20. |
boards | list of strings | departures, arrivals or both (default departures). |
date | string | YYYY-MM-DD departure date of the train from its origin (default today in Italy). The feed covers today and recent days. |
time | string | HH:MM Italian time the station board starts from (default now). |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/italy-train-status/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"trainNumbers": ["9600"], "boards": ["departures"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Private Jet Tracker API: Live Positions & FAA Owners API
Live positions of private and business jets from open ADS-B data, joined to the FAA registry owner: track by tail number, transponder hex, owner name (e.g.
Private Jet Trips API: Flights by Tail, Owner & Airport API
Recent private and business jet trips with departure and arrival airports, times and duration, recorded from open ADS-B data every 10 minutes and joined to FAA registered owners.
Public Holidays API
Public and bank holidays for 100+ countries by year or date range, with regional (state/province) holidays, holiday types, long weekends with bridge days, worldwide upcoming holidays, and an is-it-a-holiday check for any list of dates..
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
TSA Checkpoint Travel Numbers + BTS Transportation Stats API
Daily TSA airport checkpoint passenger counts since 2019 with year-over-year and 7-day averages, plus BTS monthly transportation statistics: airline passengers, on-time performance, air cargo, freight rail, trucking, transit and the Transportation Services Index..
US Travel Advisories API: State Dept Levels by Country API
Official US State Department travel advisories for every country: level 1-4, risk indicators (crime, terrorism, unrest, health, kidnapping, wrongful detention), dates and full text.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com