{"uid":"cap_ThQqiTbDr3sfP0B-w55XG","slug":"stabletravel-locations-00f3507d","name":"StableTravel Locations Search","description":"Search locations (airports, cities) by keyword","url":"https://stabletravel.dev/api/reference/locations?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"view":"LIGHT","keyword":"New York","subType":"AIRPORT,CITY","page[limit]":5},"response":{"data":[{"id":"CNYC","name":"NEW YORK","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/CNYC","methods":["GET"]},"type":"location","address":{"cityName":"NEW YORK","countryName":"UNITED STATES OF AMERICA"},"subType":"CITY","iataCode":"NYC","detailedName":"NEW YORK/NY/US"},{"id":"AJFK","name":"JOHN F KENNEDY INTL","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/AJFK","methods":["GET"]},"type":"location","address":{"cityName":"NEW YORK","countryName":"UNITED STATES OF AMERICA"},"subType":"AIRPORT","iataCode":"JFK","detailedName":"NEW YORK/NY/US:JOHN F KENNEDY"},{"id":"AEWR","name":"NEWARK LIBERTY INTL","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/AEWR","methods":["GET"]},"type":"location","address":{"cityName":"NEW YORK","countryName":"UNITED STATES OF AMERICA"},"subType":"AIRPORT","iataCode":"EWR","detailedName":"NEW YORK/NJ/US:NEWARK LIBERTY"},{"id":"ALGA","name":"LAGUARDIA","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ALGA","methods":["GET"]},"type":"location","address":{"cityName":"NEW YORK","countryName":"UNITED STATES OF AMERICA"},"subType":"AIRPORT","iataCode":"LGA","detailedName":"NEW YORK/NY/US:LAGUARDIA"},{"id":"ASWF","name":"STEWART INTERNATIONAL","self":{"href":"https://api.amadeus.com/v1/reference-data/locations/ASWF","methods":["GET"]},"type":"location","address":{"cityName":"NEW YORK","countryName":"UNITED STATES OF AMERICA"},"subType":"AIRPORT","iataCode":"SWF","detailedName":"NEW YORK/NY/US:STEWART INTERNA"}],"meta":{"count":6,"links":{"last":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=New%20York&view=LIGHT&page%5Boffset%5D=1&page%5Blimit%5D=5","next":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=New%20York&view=LIGHT&page%5Boffset%5D=5&page%5Blimit%5D=5","self":"https://api.amadeus.com/v1/reference-data/locations?subType=AIRPORT,CITY&keyword=New%20York&view=LIGHT&page%5Blimit%5D=5"}}}},"exampleRequest":{"view":"LIGHT","keyword":"New York","subType":"AIRPORT,CITY","page[limit]":5},"tags":["amadeus","flightaware","flights","hotels","activities","transfers","travel","data","web"],"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"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.0054","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a5hsqkqicR4auAsFS6r3h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0054","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_XKhpnZBjQT4jVv8e2zrCi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.0054","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableTravel","brandSlug":"stabletravel","brandBaseUrl":"https://stabletravel.dev","brandDocsUrl":"https://stabletravel.dev","whatItDoes":"Search for airports and cities by keyword, returning matching location records filterable by sub-type and country","exampleAgentPrompt":"Search for airports and cities matching 'Charles de Gaulle' — filter by AIRPORT,CITY subtype and limit results to 5.","exampleUseCases":null,"resultDescription":"An array of location objects matching the keyword, each containing location name, IATA/ICAO codes, sub-type (airport or city), country, and analytics metadata. Pagination metadata is also returned.","failureModes":["Missing required 'keyword' or 'subType' parameters returns a 400 error","No results found for obscure or misspelled keywords returns empty data array","Invalid countryCode returns error or empty results","Rate limiting or payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable city or airport name into structured travel location data (e.g., IATA codes) before booking flights, hotels, or transfers. Prefer this over generic geocoding APIs when the downstream action involves Amadeus-powered travel services on StableTravel.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:36:35.262Z","isFirstParty":false,"canonicalSlug":"stabletravel-locations-00f3507d"}