--- title: "One highway's charging gaps: every gap, the chargers that close them, and its months" method: GET path: "/v1/countries/{country}/routes/{slug}" --- # One highway's charging gaps: every gap, the chargers that close them, and its months `GET /v1/countries/{country}/routes/{slug}` ## Request - Base URL: `https://api.chargealong.io` - URL: `https://api.chargealong.io/v1/countries/{country}/routes/{slug}` - Auth: none required Every gap along the highway in order at 50 kW and at 150 kW, the chargers that close a gap at 50 kW in order along the road with their distance off it, and up to twelve months of history, newest first. The same rules as listRoutes. ## Path parameters - `country` string, required - `slug` string, required ## Response `200` The highway - RouteResponse: The answer, in the envelope every read shares. - `data` RoutePage, required: One highway: its figures, every gap, the chargers that close them and its months. Not its line, which is drawn on the site's map only. - `country` Country, required: A country with charging sites. - `iso2` string, required: ISO 3166-1 alpha-2 code. - `slug` string, required: The country in URLs: australia, new-zealand. - `name` string, required: The country's English name. - `site_count` integer, required: Charging sites listed in the country, active and unavailable. - `route` RouteSummary, required: A highway's headline figures for its newest month. - `slug` string, required: The highway in URLs: hume-highway. - `name` string, required: Its name: Hume Highway. A route that runs over several highways is named as a route. - `via` string, required: Its ends: Sydney to Melbourne. - `length_km` number, required: Its length by road, from end to end. - `path` string, required: Its page on chargealong.io. - `month` string, required: The month the figures are for, YYYY-MM. - `fast` GapFigure, required: A highway's longest gap at one threshold: fast is 50 kW, ultra_fast 150 kW. - `min_kw` 50 | 150, required: The threshold: 50 or 150. - `chargers` integer, required: Chargers along the highway that count at this threshold. - `longest_km` number, required: The longest stretch without one, by road. - `from` string, required: The town at its start: a corridor town within 20 km of the charger, else the charger's own suburb, or the highway's end. - `to` string, required: The town at its end, named the same way. - `change_km` number: longest_km less the month before's: negative is better. Absent when there is no month before. - `ultra_fast` GapFigure, required: A highway's longest gap at one threshold: fast is 50 kW, ultra_fast 150 kW. - `min_kw` 50 | 150, required: The threshold: 50 or 150. - `chargers` integer, required: Chargers along the highway that count at this threshold. - `longest_km` number, required: The longest stretch without one, by road. - `from` string, required: The town at its start: a corridor town within 20 km of the charger, else the charger's own suburb, or the highway's end. - `to` string, required: The town at its end, named the same way. - `change_km` number: longest_km less the month before's: negative is better. Absent when there is no month before. - `gaps` RouteGaps, required: Every gap in order, at each threshold. - `fast` RouteGap[], required: At 50 kW. - `from_km` number, required: Where it starts, by road from the highway's start. - `to_km` number, required: Where it ends. - `length_km` number, required: How long it is. - `from` string, required: The town at its start. - `to` string, required: The town at its end. - `from_site` string: The charger at its start, by public id. Absent at the highway's start. - `to_site` string: The charger at its end. Absent at the highway's end. - `ultra_fast` RouteGap[], required: At 150 kW. - `from_km` number, required: Where it starts, by road from the highway's start. - `to_km` number, required: Where it ends. - `length_km` number, required: How long it is. - `from` string, required: The town at its start. - `to` string, required: The town at its end. - `from_site` string: The charger at its start, by public id. Absent at the highway's start. - `to_site` string: The charger at its end. Absent at the highway's end. - `chargers` RouteCharger[], required: Chargers that close a gap at 50 kW, in order along the road. - `public_id` string, required: Its id: /v1/sites/{publicID}. - `name` string, required: Its name. - `path` string, required: Its page on chargealong.io. - `along_km` number, required: How far along the highway, by road. - `offset_km` number, required: How far off the road it is, in a straight line; within 5. - `max_dc_kw` number: Its fastest DC plug. Absent when no source says. - `lat` number, required: Where it is, WGS84. - `lng` number, required: Where it is, WGS84. - `history` RouteMonth[], required: Up to twelve months, newest first. - `month` string, required: YYYY-MM. - `fast_longest_km` number, required: Longest gap at 50 kW. - `fast_chargers` integer, required: Chargers that counted at 50 kW. - `ultra_fast_longest_km` number, required: Longest gap at 150 kW. - `ultra_fast_chargers` integer, required: Chargers that counted at 150 kW. - `next_cursor` string: Present only on a paged list: pass it back to read the next page. No public read is paged today. - `generated_at` string, date-time, required: When this answer was generated, UTC. Answers are cached, so it can be up to an hour old. ## Other responses - `404`: No such country, or no such highway computed there - `503`: The database is unavailable --- [API](https://skmtc.dev/chargealong/apis/chargealong-api.md) · [All operations](https://skmtc.dev/chargealong/apis/chargealong-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chargealong/apis/chargealong-api/revisions/f7968808e434?raw)