DEdespegar
Geography

City by ID

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

get/cities/{id}

Request

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

Path parameters

idstring required

Internal numeric identifier of the city. E.g.: 982 (Buenos Aires).

Query parameters

productstring required

Product type used to filter configurations. E.g.: HOTELS, FLIGHTS.

languagestring required

Comma-separated list of language codes for the descriptions field. E.g.: ES,PT,EN.

ratiostring

Aspect ratio for pictures, if available. E.g.: 4:3, 16:9.

Response

OK

idstring

Internal numeric identifier of the city.

gidstring

Global identifier combining type and id. E.g.: CIT_982.

codestring

IATA or internal code of the city. E.g.: BUE, BRC.

descriptionsobject

Localized city names keyed by language code.

aliasesstring[]

List of alternative names for the city. Not always present.

timezonestring

IANA timezone identifier for the city. E.g.: America/Sao_Paulo.

timezone_offsetnumber

UTC offset of the city's timezone in hours. E.g.: -3.0.

administrative_division_idstring

Internal numeric identifier of the administrative division the city belongs to.

administrative_division_gidstring

Global identifier of the administrative division. E.g.: ADM_31655.

country_idstring

Internal numeric identifier of the country.

country_gidstring

Global identifier of the country. E.g.: COU_20010.

configurationsstring[]

List of product and platform configurations in which this city is available. Values may include product-specific bus configurations such as any_buses_ar, any_buses_br, or any_buses_cl.

picturesobject[]

List of pictures associated with the city. Always empty.

last_update_datestring date-time

Date and time of the last update to this record.

Changes

No recorded changes to this operation across all 1 revision of this API.