---
title: "Every country with charging sites, and how many each has"
method: GET
path: "/v1/countries"
---

# Every country with charging sites, and how many each has

`GET /v1/countries`

## Request

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

## Response `200`

The countries, busiest first

- CountriesResponse: Every country with charging sites.
  - `data` Country[], required: Every country with sites, busiest first.
    - `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.
  - `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

- `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)