---
title: "Find countries"
method: GET
path: "/geo/countries"
tags: ["Geo"]
---

# Find countries

`GET /geo/countries`

Find countries, filtering by optional criteria. If no criteria are set, you will get back all known countries.

## Query parameters

- `currencyCode` string
- `namePrefix` string
- `namePrefixDefaultLangResults` boolean
- `asciiMode` boolean
- `hateoasMode` boolean
- `languageCode` string
- `limit` integer
- `offset` integer
- `sort` string

## Response `200`

A list of countries

- CountriesResponse — A list of countries
  - `errors` Error[]
    - `code` 'ACCESS_DENIED' | 'ENTITY_NOT_FOUND' | 'INCOMPATIBLE' | 'PARAM_INVALID' | 'PARAMS_MUTUALLY_EXCLUSIVE' | 'REQUEST_UNPROCESSABLE' — One of a set of enumerated error codes representing the types of errors that can occur processing a request
    - `message` string
  - `links` Link[]
    - `href` string
    - `rel` string
  - `metadata` Metadata — Result metadata (currently only associated with collection results)
    - `currentOffset` integer — The zero-ary offset into the results (0 is the first result)
    - `totalCount` integer — The total number of results across pages
  - `data` CountrySummary[]
    - `code` string — The ISO-3166 country code
    - `currencyCodes` string[] — A list of supported ISO-4217 currency codes
    - `name` string — The country name (varies by languageCode)
    - `wikiDataId` string — The country WikiData id

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Unauthorized
- `403` — 403 - Forbidden

---

[API](https://skmtc.net/mashape/apis/geodb.md) · [All operations](https://skmtc.net/mashape/apis/geodb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mashape/geodb/versions/d1b1bd32c947/schema)