get reference data recommended locations - amadeus-travel-recommendations API | Specway Docs

GET

GET recommended destinations

https://test.api.amadeus.com/v1/reference-data/recommended-locations

Access Token Required: API Key

Query Params

cityCodesstringrequired

City used by the algorythm to recommend new destination. Several cities can be specified using comma. City codes follow [IATA standard](http://www.iata.org/publications/Pages/code-search.aspx)

travelerCountryCodestringDefault: FR

Origin country of the traveler following [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US)

destinationCountryCodesstring

List of country the traveler want to visit, separated with comma. Country codes follow [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US)

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://test.api.amadeus.com/v1/reference-data/recommended-locations' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET