---
title: "Country by ID"
method: GET
path: "/countries/{id}"
tags: ["Geography"]
---

# Country by ID

`GET /countries/{id}`

## Request

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

Returns the details of a specific country identified by its internal numeric ID.

## Path parameters

- `id` string, required

## Query parameters

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

## Response `200`

OK

- object
  - `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. E.g.: `54`, `55`.
  - `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.

## Other responses

- `400`: Bad Request. A required parameter is missing or invalid.
- `401`: Unauthorized. The request is missing a valid API key.
- `404`: Not Found. No country found for the given ID.
- `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)
