What four real feeds turned up
Checked on 2026-11-19 with the same engine (full output and file hashes):
- Google's GTFS sample feed (2007): expired since 2010-12-31; 13 short rows in stop_times.txt; a header field
drop_off_timethat should bedrop_off_type. - BART: no errors. feed_info.txt ends 2026-08-30 while the calendar runs to 2027-01-10.
- Halifax Transit: no errors. Service ends 2026-11-29; 153,548 times carry a leading space; 60 routes print black on pure blue (2.44:1).
- TriMet: no errors in 2.6 million stop times; 70 stop names end in a space; one route has no trips.
These are format checks, not a judgement of anyone's service.
Files and CSV
| Code | Level | What it means | Source |
|---|---|---|---|
missing_required_file | error | agency.txt, routes.txt, trips.txt or stop_times.txt is absent, or stops.txt without locations.geojson, or feed_info.txt when translations.txt is present. | Reference, Dataset Files |
missing_calendar | error | Neither calendar.txt nor calendar_dates.txt exists, so no trip has a date. | Reference, Dataset Files |
files_in_subfolder | error | The .txt files sit inside a folder in the zip. Zip the files, not the folder. | Reference, File Requirements |
file_name_case | error | A file name differs from a standard one only by case (Stops.txt). | Reference, File Requirements |
duplicate_file | error | Two entries with the same file name in different folders. | Reference, File Requirements |
unknown_file | info | A file the reference does not define, usually a producer's extension (BART's directions.txt). Ignored by most consumers. | Reference, Dataset Files |
empty_file | error | The file has no header line. | Reference, File Requirements |
no_rows | error | agency.txt has a header but no agencies. | Reference, agency.txt |
empty_header | error | A column with no field name. | Reference, File Requirements |
duplicate_header | error | A field name appears twice in one header. | Reference, File Requirements |
header_case | error | A field name differs from a standard one only by case. | Reference, File Requirements |
header_spaces | warning | Spaces around a field name in the header. | Reference, File Requirements |
unknown_field | info | A field the reference does not define for that file. Google's own sample feed has drop_off_time, a misspelling of drop_off_type. | Reference, Field Definitions |
missing_required_field | error | A required field is missing from the header. | Reference, Field Definitions |
too_many_values | error | A row has more values than the header: often an unquoted comma inside a name. | RFC 4180 |
short_row | warning | A row has fewer values than the header. Most readers fill in empty values; strict ones reject the row. | RFC 4180 |
unterminated_quote | error | A quoted value is never closed. | RFC 4180 |
newline_in_value | error | A quoted value contains a line break. | Reference, File Requirements |
stray_quote | warning | A quotation mark inside an unquoted value. | Reference, File Requirements |
value_spaces | warning | A value with spaces around it. Halifax Transit's feed writes 153,548 times as " 5:49:00". | Reference, File Requirements |
Values
| Code | Level | What it means | Source |
|---|---|---|---|
missing_required_value | error | A required field is empty (or a stop time has no stop_id and no on-demand location). | Reference, Field Definitions |
invalid_time | error | Not HH:MM:SS. Hours may pass 24 (25:35:00 is 1:35 next morning); minutes and seconds may not pass 59. | Reference, Field Types |
invalid_date | error | Not a real date written YYYYMMDD. | Reference, Field Types |
invalid_color | error | Not six hex digits. A leading # is not allowed. | Reference, Field Types |
invalid_timezone | error | Not an IANA time zone the browser or Node knows (America/Chicgo). | Reference, Field Types |
invalid_url | error | Not a full URL starting with http:// or https://. | Reference, Field Types |
invalid_email | error | Not shaped like an email address. | Reference, Field Types |
invalid_lang | error | Not shaped like a BCP 47 language code. | Reference, Field Types |
invalid_lat | error | Not a number from -90 to 90. | Reference, Field Types |
invalid_lon | error | Not a number from -180 to 180. | Reference, Field Types |
invalid_uint | error | Not a whole number 0 or more (stop_sequence, shape_pt_sequence, route_sort_order). | Reference, Field Signs |
invalid_pint | error | Not a whole number above 0 (headway_secs). | Reference, Field Signs |
invalid_float | error | Not a number. | Reference, Field Types |
invalid_ufloat | error | Not a number 0 or more (shape_dist_traveled). | Reference, Field Signs |
invalid_enum | error | Not one of the listed options (location_type 0-4, route_type 0-7, 11, 12, exception_type 1 or 2 and so on). | Reference, Field Definitions |
extended_route_type | info | A route_type from the extended HVT-style range (100-1799), which the reference does not list. | Reference, routes.txt |
Keys and references
| Code | Level | What it means | Source |
|---|---|---|---|
duplicate_key | error | A primary key repeats: agency_id, stop_id, route_id, trip_id, service_id in calendar.txt, (service_id, date), (trip_id, stop_sequence) or (shape_id, shape_pt_sequence). | Reference, Dataset Attributes |
unknown_reference | error | An ID points at nothing: a trip's route or shape, a stop time's trip or stop, a route's agency, a stop's parent_station, a frequency's trip. | Reference, Field Definitions |
unknown_service | error | A trip's service_id is in neither calendar file, so the trip never runs. | Reference, trips.txt |
missing_agency_id | error | More than one agency and at least one has no agency_id. | Reference, agency.txt |
agency_timezones_differ | error | Agencies in one feed with different agency_timezone values. | Reference, agency.txt |
missing_route_agency | error | More than one agency and a route has no agency_id. | Reference, routes.txt |
network_id_conflict | error | routes.txt has network_id while networks.txt or route_networks.txt exists. | Reference, Dataset Files |
Stops
| Code | Level | What it means | Source |
|---|---|---|---|
missing_stop_name | error | A stop, station or entrance with no stop_name. | Reference, stops.txt |
missing_stop_position | error | A stop, station or entrance with no stop_lat or stop_lon. | Reference, stops.txt |
stop_at_null_island | error | A stop at exactly 0,0, in the Gulf of Guinea: a missing position written as zeros. | This tool |
stop_far_from_others | warning | A stop over 100 km from the feed's median stop position and over 20 times the median stop's distance: swapped latitude and longitude, a dropped minus sign or a typo. | This tool's threshold |
missing_parent_station | error | An entrance, generic node or boarding area with no parent_station. | Reference, stops.txt |
station_with_parent | error | A station (location_type 1) with a parent_station. | Reference, stops.txt |
wrong_parent_type | error | A parent_station that is not a station (or, for a boarding area, not a platform). | Reference, stops.txt |
platform_far_from_station | warning | A platform more than 1 km from its parent station. | This tool's threshold |
stop_time_at_station | error | A stop time at a station, entrance or node instead of a stop or platform. | Reference, stop_times.txt |
all_caps_name | warning | A stop name in ALL CAPS. Names should use mixed case. | Reference, File Requirements |
desc_repeats_name | info | stop_desc is the same as stop_name. | Reference, stops.txt |
unused_stop | info | A stop (location_type 0) no trip serves. | Convention |
Routes
| Code | Level | What it means | Source |
|---|---|---|---|
missing_route_name | error | A route with neither route_short_name nor route_long_name. | Reference, routes.txt |
long_short_name | warning | route_short_name over 12 characters. | Reference, routes.txt |
same_route_names | warning | route_short_name and route_long_name are identical. | Convention |
low_color_contrast | warning | route_text_color on route_color below 3:1 contrast. The reference asks for sufficient contrast; the 3:1 line is WCAG 2's for large text and this tool's choice. | This tool's threshold (WCAG 2 formula) |
unused_route | warning | A route with no trips. | Convention |
Trips and stop times
| Code | Level | What it means | Source |
|---|---|---|---|
trip_without_stop_times | error | A trip with no rows in stop_times.txt. | Reference, trips.txt |
trip_with_one_stop | error | A trip that serves a single stop; a trip is two or more. | Reference, trips.txt |
missing_end_times | error | No arrival_time or departure_time at a trip's first or last stop. | Reference, stop_times.txt |
timepoint_without_time | error | timepoint=1 with no times. | Reference, stop_times.txt |
departure_before_arrival | error | departure_time earlier than arrival_time at the same stop. | Reference, stop_times.txt |
time_goes_backwards | error | A stop's time earlier than the stop before it on the trip, in stop_sequence order. | Reference, stop_times.txt |
stop_dist_decreasing | error | shape_dist_traveled going down along a trip. | Reference, stop_times.txt |
too_fast | warning | Straight-line speed between consecutive timed stops above the mode's ceiling: 150 km/h for bus, subway, trolleybus and monorail; 120 tram; 500 rail; 200 coach; 80 ferry; 50 cable, aerial and funicular. Under a minute counts as a minute. Straight-line distance is the shortest possible, so a hit is at least that fast. | This tool's threshold |
trip_over_24h | warning | More than 24 hours from first departure to last arrival: usually an hour typo. | This tool's threshold |
Shapes and frequencies
| Code | Level | What it means | Source |
|---|---|---|---|
short_shape | warning | A shape with fewer than two points. | Reference, shapes.txt |
shape_dist_decreasing | error | shape_dist_traveled going down along a shape. | Reference, shapes.txt |
unused_shape | info | A shape no trip uses. | Convention |
no_shapes | info | No shapes.txt: trip planners draw straight lines between stops. | Reference, Dataset Files |
end_before_start | error | An end before its start: calendar end_date, frequency end_time or feed_end_date. | Reference, calendar.txt, frequencies.txt, feed_info.txt |
overlapping_frequencies | error | Two headway periods for one trip overlap. | Reference, frequencies.txt |
Calendar and feed dates
| Code | Level | What it means | Source |
|---|---|---|---|
no_service_dates | error | No date on which any trip runs. | Reference, calendar.txt |
feed_expired | error | The last date with service is before the day you check: apps show no service. | Reference, Dataset Publishing |
feed_expires_within_7_days | warning | Service ends within 7 days. A feed should be valid for at least the next 7. | Reference, Dataset Publishing |
feed_covers_under_30_days | info | Service ends within 30 days. A feed should, if possible, cover the next 30. Halifax Transit's, checked on 2026-11-19, ends on 2026-11-29. | Reference, Dataset Publishing |
feed_not_started | info | The first service date is after today. | Convention |
no_service_day | warning | A day in the next 30, inside the feed's own service period, with no service at all. | This tool |
service_never_runs | warning | A service_id that trips use but that has no running date. | Reference, calendar.txt |
unused_service | info | A service_id no trip uses. | Convention |
no_feed_info | info | No feed_info.txt (recommended). | Reference, Dataset Files |
too_many_rows | error | feed_info.txt has more than one row. | Reference, feed_info.txt |
no_feed_contact | info | Neither feed_contact_email nor feed_contact_url. | Reference, feed_info.txt |
feed_info_expired | warning | feed_end_date is in the past. BART's feed_info.txt said 2026-08-30 on 2026-11-19. | Reference, feed_info.txt |
feed_info_end_before_service | warning | feed_end_date is earlier than the last service date in the calendar: one of them is stale. BART's calendar runs to 2027-01-10. | Reference, feed_info.txt |