---
title: "Search countries"
method: POST
path: "/geo/countries"
tags: ["Geo"]
---

# Search countries

`POST /geo/countries`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/geo/countries`
- Auth: API key in header `Authorization`

Searches countries by name. Returns up to 100 countries per page.

## Request body

- SearchCountriesRequest, nullable
  - `query` string, nullable
  - `page` integer

## Response `200`

OK

- PaginatedListOfCountryInfo
  - `items` CountryInfo2[], required: The items in the list
    - `code` string: The ISO 3166-1 alpha-2 code of the country
    - `name` string: The name of the country
    - `latitude` number, float, nullable: The latitude of the country
    - `longitude` number, float, nullable: The longitude of the country
  - `page` integer: The current page number. 1-indexed
  - `totalPages` integer: The total number of pages
  - `totalItems` integer: The total number of items in the list

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)