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

# Countries

`GET /countries`

## Request

- Base URL: `https://api-dev.despegar.com/v3`
- URL: `https://api-dev.despegar.com/v3/countries`
- Auth: API key in header `x-apikey`

Returns the full list of countries available in the system, including multilingual names, capital city, continent, phone codes, and product configurations.

## Query parameters

- `product` string, required
- `language` string, required

## Response `200`

OK

- object
  - `items` object[]: List of countries.
    - `id` string: Internal numeric identifier of the country.
    - `gid` string: Global identifier combining type and id. E.g.: `COU_20010`.
    - `code` string: ISO 3166-1 alpha-2 country code. E.g.: `AR`, `BR`, `MX`.
    - `alternative_code` string: ISO 3166-1 alpha-3 country code. E.g.: `ARG`, `BRA`, `MEX`.
    - `descriptions` object: Localized country names keyed by language code. E.g.: `{ "es": "Argentina", "pt": "Argentina", "en": "Argentina" }`.
    - `continent_id` string: Internal numeric identifier of the continent.
    - `continent_gid` string: Global identifier of the continent. E.g.: `CON_30003`.
    - `capital_id` string: Internal numeric identifier of the capital city.
    - `capital_gid` string: Global identifier of the capital city. E.g.: `CIT_982`.
    - `capital` object: Basic information about the capital city.
      - `id` string: Internal numeric identifier of the capital.
      - `offset` number: UTC timezone offset of the capital city in hours.
    - `phone_code` string: International phone dialing code for the country. E.g.: `54`, `55`, `1-268`.
    - `intl_access_code` string: International access code used when dialing out of the country. E.g.: `00`, `011`.
    - `configurations` string[]: List of product and platform configurations in which this country is available. Not all countries include every configuration (e.g. `any_buses_any` is only present for select countries).
    - `pictures` object[]: List of pictures associated with the country. Always empty.
    - `last_update_date` string, date-time: Date and time of the last update to this record.
  - `paging` object: Pagination information for the response.
    - `offset` integer: Starting index of the returned results.
    - `limit` integer: Maximum number of results returned per page.
    - `total` integer: Total number of countries available.

## Other responses

- `400`: Bad Request. A required query parameter is missing or invalid.
- `401`: Unauthorized. The request is missing a valid API key.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/despegar/apis/geography-api.md) - [All operations](https://skmtc.dev/despegar/apis/geography-api/llms.txt) - [OpenAPI document](https://skmtc.dev/despegar/apis/geography-api/revisions/68ba7194d527?raw)