{"files":{"SKILL.md":"---\nname: flight-cheapest-date-search\ndescription: \"Flight Cheapest Date Search API skill. Use when working with Flight Cheapest Date Search for shopping. Covers 1 endpoint.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Flight Cheapest Date Search\nAPI version: 1.0.6\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 /shopping/flight-dates -- find the cheapest flight dates from an origin to a destination.\n3. Explore available endpoints below\n\n## Endpoints\n1 endpoint across 1 group. See references/api-spec.lap for full details.\n\n### Shopping\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /shopping/flight-dates | Find the cheapest flight dates from an origin to a destination. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all flight-dates?\" -> GET /shopping/flight-dates\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 Flight Cheapest Date Search\n@base https://test.api.amadeus.com/v1\n@version 1.0.6\n@endpoints 1\n@toc shopping(1)\n\n@endpoint GET /shopping/flight-dates\n@desc Find the cheapest flight dates from an origin to a destination.\n@required {origin: any # IATA code of the city from which the flight will depart  [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) - e.g. MAD for Madrid, destination: any # IATA code of the city to which the flight is going.  [IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) - e.g. MUC for Munich}\n@optional {departureDate: any # the date, or range of dates, on which the flight will depart from the origin. Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2017-12-25. Ranges are specified with a comma and are inclusive, oneWay: any # if this parameter is set to true, only one-way flights are considered. If this parameter is not set or set to false, only round-trip flights are considered, duration: any # exact duration or range of durations of the travel, in days. This parameter must not be set if oneWay is true. Ranges are specified with a comma and are inclusive, e.g. 2,8, nonStop: any # if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered, maxPrice: any # defines the price limit for each offer returned. The value should be a positive number, without decimals, viewBy: any # view the flight dates by DATE, DURATION, or WEEK. View by DATE (default when oneWay is true) to get the cheapest flight dates for every departure date in the given range. View by DURATION (default when oneWay is false) to get the cheapest flight dates for every departure date and for every duration in the given ranges. View by WEEK to get the cheapest flight destination for every week in the given range of departure dates. Note that specifying a detailed view but large ranges may result in a huge number of flight dates being returned. For some very large numbers of flight dates, the API may refuse to provide a response}\n@returns(200) Success\n@errors {400: code    | title                                  ------- | -------------------------------------  425     | INVALID DATE 477     | INVALID FORMAT 2668    | PARAMETER COMBINATION INVALID/RESTRICTED 4926    | INVALID DATA RECEIVED 32171   | MANDATORY DATA MISSING, 404: code    | title                                  ------- | -------------------------------------  6003    | ITEM/DATA NOT FOUND OR DATA NOT EXISTING, 500: Unexpected error}\n\n@end\n"}}