{"files":{"SKILL.md":"---\nname: points-of-interest\ndescription: \"Points of Interest API skill. Use when working with Points of Interest for reference-data. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Points of Interest\nAPI version: 1.1.1\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/pois -- returns points of interest for a given location and radius.\n3. Explore available endpoints below\n\n## Endpoints\n3 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/pois | Returns points of interest for a given location and radius. |\n| GET | /reference-data/locations/pois/{poisId} | Retieve one point of interest by its Id. |\n| GET | /reference-data/locations/pois/by-square | Returns points of interest for a given area |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all pois?\" -> GET /reference-data/locations/pois\n- \"Get pois details?\" -> GET /reference-data/locations/pois/{poisId}\n- \"List all by-square?\" -> GET /reference-data/locations/pois/by-square\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 Points of Interest\n@base https://test.api.amadeus.com/v1\n@version 1.1.1\n@endpoints 3\n@toc reference-data(3)\n\n@endpoint GET /reference-data/locations/pois\n@desc Returns points of interest for a given location and radius.\n@required {latitude: any # Latitude (decimal coordinates), longitude: any # Longitude (decimal coordinates)}\n@optional {radius: any # radius of the search in Kilometer. Can be from 0 to 20, default value is 1 Km., page[limit]: any # maximum items in one page, page[offset]: any # start index of the requested page, categories: any # category of the location.   Multiple value can be selected using a comma i.e. SIGHTS, SHOPPING}\n@returns(200) Successful Operation\n@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING}\n\n@endpoint GET /reference-data/locations/pois/{poisId}\n@desc Retieve one point of interest by its Id.\n@returns(200) Successful Operation\n@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING, 404: Not Found}\n\n@endpoint GET /reference-data/locations/pois/by-square\n@desc Returns points of interest for a given area\n@required {north: any # Latitude north of bounding box (decimal coordinates), west: any # Longitude west of bounding box (decimal coordinates), south: any # Latitude south of bounding box (decimal coordinates), east: any # Longitude east of bounding box (decimal coordinates)}\n@optional {page[limit]: any: any # maximum items in one page, page[offset]: any # start index of the requested page, categories: any # category of the location.   Multiple value can be selected using a comma i.e. SIGHTS, SHOPPING}\n@returns(200) Successful Operation\n@errors {400: code    | title                                  ------- | -------------------------------------  477     | INVALID FORMAT 572     | INVALID OPTION 4926    | INVALID DATA RECEIVED                32171   | MANDATORY DATA MISSING}\n\n@end\n"}}