---
title: "A country's highways ranked by their longest stretch without a fast charger"
method: GET
path: "/v1/countries/{country}/routes"
---

# A country's highways ranked by their longest stretch without a fast charger

`GET /v1/countries/{country}/routes`

## Request

- Base URL: `https://api.chargealong.io`
- URL: `https://api.chargealong.io/v1/countries/{country}/routes`
- Auth: none required

Each highway's longest gap between chargers a car of that country can fast charge at, at 50 kW and at 150 kW, with the towns at each end, how many chargers count, the month the figures are for and the change since the month before. Recomputed on the 2nd of each month. A charger counts when it is active, within 5 km of the road, and has a DC plug of at least the threshold in the standard the country's cars use (CCS2 in Australia, New Zealand, Great Britain and Ireland; CCS1 or NACS in the United States and Canada); power a source leaves out never counts. Distances and place names only: the road's line is not published.

## Path parameters

- `country` string, required

## Response `200`

The highways, longest gap at 50 kW first

- RoutesResponse: The answer, in the envelope every read shares.
  - `data` RouteIndex, required: A country's highways ranked by their longest gap without a fast charger.
    - `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.
    - `routes` RouteSummary[], required: Highways, longest gap at 50 kW first. Empty until a country's first month is computed.
      - `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.
  - `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
- `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)