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

# List Countries

`GET /countries/`

## Request

- Base URL: `https://api.financialreports.eu`
- URL: `https://api.financialreports.eu/countries/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

**Access Level Required:** Requires **Standard Access (Level 1)**.

---
Retrieve a list of all supported countries.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Success

- PaginatedCountryList
  - `count` integer, required: Total matching results. Exact for cheap queries, an estimate on broad or expensive ones. Do not use it to decide when to stop: follow `next` until it is null.
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Country[], required
    - `name` string, required: English short name from ISO 3166
    - `alpha_2` string, required: ISO 3166-1 alpha-2 code (two-letter country code)
    - `alpha_3` string, required: ISO 3166-1 alpha-3 code (three-letter country code)
    - `numeric` string, required: ISO 3166-1 numeric code (three-digit country code)

## Other responses

- `403`: Missing or invalid API key, or the plan does not include this endpoint.
- `429`: Rate limit, plan quota or spend cap reached.

---

[API](https://skmtc.dev/financialreports/apis/financialfilings-api.md) · [All operations](https://skmtc.dev/financialreports/apis/financialfilings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/financialreports/apis/financialfilings-api/revisions/a780251d6b05?raw)