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

# List Countries

`GET /api/countries`

## Request

- Base URL: `https://data.getplace.io` (the document declares no server; this is the origin it was published from)
- URL: `https://data.getplace.io/api/countries`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`

List all countries with optional filters. Uses cached reviews_count for speed.

Client users only see countries they have access to (based on menu_access_items).
Admin users see all countries.

## Query parameters

- `is_active` boolean, nullable
- `has_reviews` boolean, nullable
- `has_menu` boolean, nullable

## Response `200`

Successful Response

- CountryResponse[]
  - `id` integer, required
  - `name` string, required
  - `code` string, required
  - `status` integer, required
  - `updated` string, date-time, nullable
  - `cities_count` integer
  - `reviews_count` integer
  - `chain_matching_enabled` boolean
  - `sync_enabled` boolean
  - `last_sync` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getplace/apis/getplace-insights-api.md) - [All operations](https://skmtc.dev/getplace/apis/getplace-insights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getplace/apis/getplace-insights-api/revisions/0f337387603f?raw)
