{"files":{"SKILL.md":"---\nname: airport-city-search\ndescription: \"Airport & City Search API skill. Use when working with Airport & City Search for reference-data. Covers 2 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Airport & City Search\nAPI version: 1.2.3\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://test.api.amadeus.com/v1\n\n## Setup\n1. No auth setup needed\n2. GET /reference-data/locations -- returns a list of airports and cities matching a given keyword.\n3. Explore available endpoints below\n\n## Endpoints\n2 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Reference-data\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /reference-data/locations | Returns a list of airports and cities matching a given keyword. |\n| GET | /reference-data/locations/{locationId} | Returns a specific airports or cities based on its id. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all locations?\" -> GET /reference-data/locations\n- \"Get location details?\" -> GET /reference-data/locations/{locationId}\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Airport & City Search\n@base https://test.api.amadeus.com/v1\n@version 1.2.3\n@endpoints 2\n@toc reference-data(2)\n\n@endpoint GET /reference-data/locations\n@desc Returns a list of airports and cities matching a given keyword.\n@required {subType: any # sub type of the location (AIRPORT and/or CITY), keyword: any # keyword that should represent the start of a word in a city or airport name or code.   Supported charaters are: A-Za-z0-9./:-'()\"}\n@optional {countryCode: any # Country code of the location using [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US)., page[limit]: any # maximum items in one page, page[offset]: any # start index of the requested page, sort: any # defines on which attribute the sorting will be done: * analytics.travelers.score - sort by the number of travelers by airport or city, the airports and cities with the highest traffic are on top of the results, view: any # select the level of information of the reply: * LIGHT - Gives only the IATACode, name, detailedName, cityName and countryName * FULL - Adds on top of the LIGHT information the timeZoneOffset, geocode, detailed address and travelers.score default option is FULL}\n@returns(200) Successful Operation\n@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION  2781    | INVALID LENGTH 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING}\n\n@endpoint GET /reference-data/locations/{locationId}\n@desc Returns a specific airports or cities based on its id.\n@required {locationId: any # identifier of the location}\n@returns(200) Successful Operation\n@errors {400: code    | title                                  ------- | -------------------------------------  572     | INVALID OPTION, 404: Not Found}\n\n@end\n"}}