{"uid":"cap_HpwHJsV6B55VZUnFURm15","slug":"amadeus-eef30e3c","name":"Amadeus Location Search (Airports & Cities)","description":"Pay-per-request access to flights, award availability, hotels, activities, and transfers. No auth, no subscriptions.","url":"https://stabletravel.dev/api/reference/locations","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["subType","keyword"],"properties":{"sort":{"enum":["analytics.travelers.score"],"type":"string"},"view":{"enum":["FULL","LIGHT"],"type":"string"},"keyword":{"type":"string","description":"Search keyword (city or airport name)"},"subType":{"enum":["AIRPORT","CITY","AIRPORT,CITY"],"type":"string","description":"Location sub-type filter"},"countryCode":{"type":"string","description":"ISO 3166-1 country code"},"page[limit]":{"type":"number","description":"Maximum results per page"},"page[offset]":{"type":"number","description":"Results offset"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data"],"properties":{"data":{"type":"array","items":{}},"meta":{}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":[{"name":"CHARLES DE GAULLE","type":"location","address":{"cityName":"PARIS","countryCode":"FR"},"geoCode":{"latitude":49.0097,"longitude":2.5479},"subType":"AIRPORT","iataCode":"CDG"}],"meta":{"count":1}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"view":"LIGHT","keyword":"London","subType":"AIRPORT,CITY","countryCode":"GB","page[limit]":10}}},"response":{"data":[{"id":"CLON","name":"LONDON","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/CLON","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"CITY","iataCode":"LON","detailedName":"LONDON/GB"},{"id":"ALHR","name":"HEATHROW","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALHR","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"LHR","detailedName":"LONDON/GB:HEATHROW"},{"id":"ALGW","name":"GATWICK","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALGW","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"LGW","detailedName":"LONDON/GB:GATWICK"},{"id":"ASTN","name":"STANSTED","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ASTN","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"STN","detailedName":"LONDON/GB:STANSTED"},{"id":"ALTN","name":"LUTON","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALTN","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"LTN","detailedName":"LONDON/GB:LUTON"},{"id":"ALCY","name":"CITY AIRPORT","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALCY","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"LCY","detailedName":"LONDON/GB:CITY AIRPORT"},{"id":"ALYX","name":"LONDON ASHFORD","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALYX","methods":["GET"]},"type":"location","address":{"cityName":"LYDD","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"LYX","detailedName":"LYDD/GB:LONDON ASHFORD"},{"id":"CLYX","name":"LYDD","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/CLYX","methods":["GET"]},"type":"location","address":{"cityName":"LYDD","countryName":"UNITED KINGDOM"},"subType":"CITY","iataCode":"LYX","detailedName":"LYDD/GB"},{"id":"ASEN","name":"SOUTHEND","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ASEN","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"SEN","detailedName":"LONDON/GB:SOUTHEND"},{"id":"ABQH","name":"BIGGIN HILL","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ABQH","methods":["GET"]},"type":"location","address":{"cityName":"LONDON","countryName":"UNITED KINGDOM"},"subType":"AIRPORT","iataCode":"BQH","detailedName":"LONDON/GB:BIGGIN HILL"}],"meta":{"count":12,"links":{"last":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=London&countryCode=GB&view=LIGHT&page%5Boffset%5D=2&page%5Blimit%5D=10","next":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=London&countryCode=GB&view=LIGHT&page%5Boffset%5D=10&page%5Blimit%5D=10","self":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=London&countryCode=GB&view=LIGHT&page%5Blimit%5D=10"}}}},"exampleRequest":{"view":"LIGHT","keyword":"London","subType":"AIRPORT,CITY","countryCode":"GB","page[limit]":10},"tags":["x402"],"displayCostAmount":"0.0054","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0054/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0054","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0054","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1Q0DAbuqhcq1N8q1mn_me","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0054","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches airports and/or cities by keyword, returning matching location records with IATA codes and metadata.","exampleAgentPrompt":"Search for airports and cities matching the keyword 'London' using Amadeus location data — show both airports and cities, filtered to the UK (country code GB), up to 10 results.","exampleUseCases":null,"resultDescription":"An array of location objects matching the keyword, each containing the location name, IATA code, sub-type (AIRPORT or CITY), country, and optionally a traveler popularity score and detailed address metadata.","failureModes":["Missing required 'keyword' or 'subType' parameters returns a 400 validation error","Invalid countryCode format returns no results or an error","Keyword with no matches returns an empty data array","Rate limiting or payment failure (x402) blocks the request","Very broad keywords may return truncated result sets requiring pagination"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable city or airport name into a structured IATA code or Amadeus location ID, especially as a prerequisite step before searching for flights or hotels. Prefer this over hardcoded IATA lookups when the user provides a free-text destination name that may be ambiguous.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:30.811Z","isFirstParty":false}