---
title: "List available countries"
method: GET
path: "/countries/"
tags: ["Countries"]
---

# List available countries

`GET /countries/`

## Request

- Base URL: `https://beachdayapi.com/v1`
- URL: `https://beachdayapi.com/v1/countries/`
- Auth: HTTP bearer

Returns all countries with beach counts, ordered by count descending.

## Response `200`

Country list

- CountryListResponse
  - `count` integer
  - `results` CountryItem[]
    - `country` string: Country name (e.g., 'Morocco', 'Algeria', 'Kenya', 'Croatia', 'Greece', 'France', 'French Polynesia', 'New Caledonia', 'Fiji', 'Samoa', 'Tonga', 'New Zealand')
    - `beach_count` integer: Number of beaches in this country

## Other responses

- `401`: Invalid or missing API key.
- `402`: Not enough credits.

---

[API](https://skmtc.dev/beachdayapi/apis/beach-day-api.md) · [All operations](https://skmtc.dev/beachdayapi/apis/beach-day-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beachdayapi/apis/beach-day-api/revisions/6c8fdd6792f5?raw)