GTFS FEED CHECK · EVERY CHECK, AND WHERE ITS RULE COMES FROM

GTFS validation errors explained

Each of the 88 finding codes the GTFS feed checker can report, what it means and its source. Reference means the GTFS Schedule Reference, revised 2026-04-27, read for this tool on 2026-11-19. This tool's threshold means a sanity limit the reference does not set, chosen loose so a hit is worth a look. Convention means housekeeping, not a rule.

Errors break a rule a consumer may reject the feed for. Warnings are probably wrong. Notes are worth knowing.

What four real feeds turned up

Checked on 2026-11-19 with the same engine (full output and file hashes):

These are format checks, not a judgement of anyone's service.

Files and CSV

CodeLevelWhat it meansSource
missing_required_fileerroragency.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_calendarerrorNeither calendar.txt nor calendar_dates.txt exists, so no trip has a date.Reference, Dataset Files
files_in_subfoldererrorThe .txt files sit inside a folder in the zip. Zip the files, not the folder.Reference, File Requirements
file_name_caseerrorA file name differs from a standard one only by case (Stops.txt).Reference, File Requirements
duplicate_fileerrorTwo entries with the same file name in different folders.Reference, File Requirements
unknown_fileinfoA file the reference does not define, usually a producer's extension (BART's directions.txt). Ignored by most consumers.Reference, Dataset Files
empty_fileerrorThe file has no header line.Reference, File Requirements
no_rowserroragency.txt has a header but no agencies.Reference, agency.txt
empty_headererrorA column with no field name.Reference, File Requirements
duplicate_headererrorA field name appears twice in one header.Reference, File Requirements
header_caseerrorA field name differs from a standard one only by case.Reference, File Requirements
header_spaceswarningSpaces around a field name in the header.Reference, File Requirements
unknown_fieldinfoA 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_fielderrorA required field is missing from the header.Reference, Field Definitions
too_many_valueserrorA row has more values than the header: often an unquoted comma inside a name.RFC 4180
short_rowwarningA row has fewer values than the header. Most readers fill in empty values; strict ones reject the row.RFC 4180
unterminated_quoteerrorA quoted value is never closed.RFC 4180
newline_in_valueerrorA quoted value contains a line break.Reference, File Requirements
stray_quotewarningA quotation mark inside an unquoted value.Reference, File Requirements
value_spaceswarningA value with spaces around it. Halifax Transit's feed writes 153,548 times as " 5:49:00".Reference, File Requirements

Values

CodeLevelWhat it meansSource
missing_required_valueerrorA required field is empty (or a stop time has no stop_id and no on-demand location).Reference, Field Definitions
invalid_timeerrorNot 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_dateerrorNot a real date written YYYYMMDD.Reference, Field Types
invalid_colorerrorNot six hex digits. A leading # is not allowed.Reference, Field Types
invalid_timezoneerrorNot an IANA time zone the browser or Node knows (America/Chicgo).Reference, Field Types
invalid_urlerrorNot a full URL starting with http:// or https://.Reference, Field Types
invalid_emailerrorNot shaped like an email address.Reference, Field Types
invalid_langerrorNot shaped like a BCP 47 language code.Reference, Field Types
invalid_laterrorNot a number from -90 to 90.Reference, Field Types
invalid_lonerrorNot a number from -180 to 180.Reference, Field Types
invalid_uinterrorNot a whole number 0 or more (stop_sequence, shape_pt_sequence, route_sort_order).Reference, Field Signs
invalid_pinterrorNot a whole number above 0 (headway_secs).Reference, Field Signs
invalid_floaterrorNot a number.Reference, Field Types
invalid_ufloaterrorNot a number 0 or more (shape_dist_traveled).Reference, Field Signs
invalid_enumerrorNot 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_typeinfoA route_type from the extended HVT-style range (100-1799), which the reference does not list.Reference, routes.txt

Keys and references

CodeLevelWhat it meansSource
duplicate_keyerrorA 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_referenceerrorAn 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_serviceerrorA trip's service_id is in neither calendar file, so the trip never runs.Reference, trips.txt
missing_agency_iderrorMore than one agency and at least one has no agency_id.Reference, agency.txt
agency_timezones_differerrorAgencies in one feed with different agency_timezone values.Reference, agency.txt
missing_route_agencyerrorMore than one agency and a route has no agency_id.Reference, routes.txt
network_id_conflicterrorroutes.txt has network_id while networks.txt or route_networks.txt exists.Reference, Dataset Files

Stops

CodeLevelWhat it meansSource
missing_stop_nameerrorA stop, station or entrance with no stop_name.Reference, stops.txt
missing_stop_positionerrorA stop, station or entrance with no stop_lat or stop_lon.Reference, stops.txt
stop_at_null_islanderrorA stop at exactly 0,0, in the Gulf of Guinea: a missing position written as zeros.This tool
stop_far_from_otherswarningA 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_stationerrorAn entrance, generic node or boarding area with no parent_station.Reference, stops.txt
station_with_parenterrorA station (location_type 1) with a parent_station.Reference, stops.txt
wrong_parent_typeerrorA parent_station that is not a station (or, for a boarding area, not a platform).Reference, stops.txt
platform_far_from_stationwarningA platform more than 1 km from its parent station.This tool's threshold
stop_time_at_stationerrorA stop time at a station, entrance or node instead of a stop or platform.Reference, stop_times.txt
all_caps_namewarningA stop name in ALL CAPS. Names should use mixed case.Reference, File Requirements
desc_repeats_nameinfostop_desc is the same as stop_name.Reference, stops.txt
unused_stopinfoA stop (location_type 0) no trip serves.Convention

Routes

CodeLevelWhat it meansSource
missing_route_nameerrorA route with neither route_short_name nor route_long_name.Reference, routes.txt
long_short_namewarningroute_short_name over 12 characters.Reference, routes.txt
same_route_nameswarningroute_short_name and route_long_name are identical.Convention
low_color_contrastwarningroute_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_routewarningA route with no trips.Convention

Trips and stop times

CodeLevelWhat it meansSource
trip_without_stop_timeserrorA trip with no rows in stop_times.txt.Reference, trips.txt
trip_with_one_stoperrorA trip that serves a single stop; a trip is two or more.Reference, trips.txt
missing_end_timeserrorNo arrival_time or departure_time at a trip's first or last stop.Reference, stop_times.txt
timepoint_without_timeerrortimepoint=1 with no times.Reference, stop_times.txt
departure_before_arrivalerrordeparture_time earlier than arrival_time at the same stop.Reference, stop_times.txt
time_goes_backwardserrorA stop's time earlier than the stop before it on the trip, in stop_sequence order.Reference, stop_times.txt
stop_dist_decreasingerrorshape_dist_traveled going down along a trip.Reference, stop_times.txt
too_fastwarningStraight-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_24hwarningMore than 24 hours from first departure to last arrival: usually an hour typo.This tool's threshold

Shapes and frequencies

CodeLevelWhat it meansSource
short_shapewarningA shape with fewer than two points.Reference, shapes.txt
shape_dist_decreasingerrorshape_dist_traveled going down along a shape.Reference, shapes.txt
unused_shapeinfoA shape no trip uses.Convention
no_shapesinfoNo shapes.txt: trip planners draw straight lines between stops.Reference, Dataset Files
end_before_starterrorAn end before its start: calendar end_date, frequency end_time or feed_end_date.Reference, calendar.txt, frequencies.txt, feed_info.txt
overlapping_frequencieserrorTwo headway periods for one trip overlap.Reference, frequencies.txt

Calendar and feed dates

CodeLevelWhat it meansSource
no_service_dateserrorNo date on which any trip runs.Reference, calendar.txt
feed_expirederrorThe last date with service is before the day you check: apps show no service.Reference, Dataset Publishing
feed_expires_within_7_dayswarningService ends within 7 days. A feed should be valid for at least the next 7.Reference, Dataset Publishing
feed_covers_under_30_daysinfoService 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_startedinfoThe first service date is after today.Convention
no_service_daywarningA day in the next 30, inside the feed's own service period, with no service at all.This tool
service_never_runswarningA service_id that trips use but that has no running date.Reference, calendar.txt
unused_serviceinfoA service_id no trip uses.Convention
no_feed_infoinfoNo feed_info.txt (recommended).Reference, Dataset Files
too_many_rowserrorfeed_info.txt has more than one row.Reference, feed_info.txt
no_feed_contactinfoNeither feed_contact_email nor feed_contact_url.Reference, feed_info.txt
feed_info_expiredwarningfeed_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_servicewarningfeed_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