# Retrieve list of countries

Retrieve a paginated list of countries stored within the Property Management System (PMS). This endpoint supports optional filtering by country name using the  query parameter, which allows partial matching for flexible searches. The response includes key country details such as country name, ISO codes, and other relevant metadata. This endpoint is useful for managing country-specific configurations, including localisation, tax settings, and currency associations. If no search criteria are provided, all available country records will be returned in a paginated format.

Endpoint: GET /api/v3/countries
Version: 3.0.4
Security: OAuth2

## Query parameters:

  - `countryName` (string)
    Name of the country to search for

  - `pageable` (object, required)

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    ID of the country
    Example: 1

  - `content.countryName` (string)
    Name of the country
    Example: "United States"

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)