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

# List all 180 countries

`GET /countries`

Returns a compact list of every country in the Warnely dataset with risk score, tier, region, and flag. Optionally filter by region.

## Query parameters

- `region` 'Europe' | 'Asia' | 'Middle East' | 'Africa' | 'Latin America' | 'North America' | 'Oceania'

## Response `200`

List of countries (alphabetical by name).

- object
  - `count` integer, required — Number of countries returned.
  - `methodology` string, uri
  - `licence` string, required
  - `attribution` string, required
  - `countries` CountryCompact[], required
    - `iso2` string, required — ISO 3166-1 alpha-2 code.
    - `iso3` string — ISO 3166-1 alpha-3 code.
    - `name` string, required — Country name (common English form).
    - `region` 'Europe' | 'Asia' | 'Middle East' | 'Africa' | 'Latin America' | 'North America' | 'Oceania'
    - `risk_score` integer — Warnely composite risk score (0 = very safe, 100 = do not travel).
    - `risk_tier` 'Very Safe' | 'Exercise Normal Caution' | 'Exercise Increased Caution' | 'High Risk' | 'Do Not Travel'
    - `flag` string — Unicode flag emoji.

---

[API](https://skmtc.dev/warnely/apis/warnely-public-api.md) · [All operations](https://skmtc.dev/warnely/apis/warnely-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/warnely/warnely-public-api/revisions/7d49fa87053e/schema)