---
title: "Lists all countries"
method: GET
path: "/countries"
tags: ["Definitions"]
---

# Lists all countries

`GET /countries`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/countries`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/countries/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all available countries. Countries are used for target group filtering purposes. `0/NA` is a special country code that can be used for scenarios where a country is not applicable.

## Response `200`

A list of countries was retrieved successfully.

- object
  - `countries` CountryListItem[]: A list of countries.
    - `id` integer: Unique identifier of the country.
    - `code` string: Unique text code of the country.
    - `name` string: A human-readable name for the country.

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)