---
title: "Get countries list"
method: GET
path: "/api/countries"
tags: ["countries"]
---

# Get countries list

`GET /api/countries`

Get list of countries. Supports optional search filter for autocomplete functionality.

## Query parameters

- `search` string, nullable — Search term to filter countries by name or ISO code (useful for autocomplete)
- `limit` integer, nullable — Maximum number of results to return (useful for autocomplete)

## Response `200`

Successful Response

- CountriesListResponse — Countries list response model.
  - `countries` CountryResponse[], required — List of countries
    - `id` integer, required — Country ID
    - `name` string, required — Country name
    - `numeric_code` string, nullable — Numeric code
    - `iso_alpha_3` string, nullable — ISO 3166-1 alpha-3 code
    - `iso_alpha_2` string, nullable — ISO 3166-1 alpha-2 code
  - `total` integer, required — Total number of countries

## Other responses

- `422` — Validation Error

---

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