Get package price calendar

POST

/v1/getPackageCalendar

Retrieve a calendar of the cheapest package prices for a destination across multiple departure airports, durations, and dates. Returns a structured response organized by departure airport → nights → departure date, with each date showing the minimum price, arrival airport, offer details, and whether it's the absolute cheapest option. Defaults to all German airports if no departure airports specified. This endpoint provides data for building flexible date search interfaces and price comparison calendars.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successfully retrieved package calendar

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Basic calendar for BarcelonaFlexible duration calendarCalendar for specific departure airportsCalendar with quality and time filters

curl --location --request POST 'https://api.ygo.ai/v1/v1/getPackageCalendar' \
--header 'Content-Type: application/json' \
--data-raw '{
    "DepartureDate": "2025-12-01",
    "ReturnDate": "2025-12-15",
    "Nights": 7,
    "Latitude": 41.3851,
    "Longitude": 2.1734,
    "Radius": 50000,
    "PersonAges": [
        30,
        28
    ],
    "Locale": "de"
}'

Response Example

200 - Calendar with multiple airports and durations

{
    "Data": {
        "DepartureAirports": {
            "FRA": {
                "5": {
                    "2025-12-01": {
                        "Price": {
                            "Amount": 650,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 5,
                        "IsCheapest": false,
                        "OfferHash": "jkl012mno345",
                        "ProductHash": "prod789ghi"
                    }
                },
                "7": {
                    "2025-12-01": {
                        "Price": {
                            "Amount": 850,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 7,
                        "IsCheapest": true,
                        "OfferHash": "abc123def456",
                        "ProductHash": "prod789xyz"
                    },
                    "2025-12-05": {
                        "Price": {
                            "Amount": 920,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 7,
                        "IsCheapest": false,
                        "OfferHash": "def456ghi789",
                        "ProductHash": "prod123abc"
                    },
                    "2025-12-08": {
                        "Price": {
                            "Amount": 875,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 7,
                        "IsCheapest": false,
                        "OfferHash": "ghi789jkl012",
                        "ProductHash": "prod456def"
                    }
                }
            },
            "MUC": {
                "7": {
                    "2025-12-01": {
                        "Price": {
                            "Amount": 890,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 7,
                        "IsCheapest": false,
                        "OfferHash": "mno345pqr678",
                        "ProductHash": "prod012jkl"
                    },
                    "2025-12-03": {
                        "Price": {
                            "Amount": 865,
                            "Currency": "EUR"
                        },
                        "ArrivalAirport": "BCN",
                        "Nights": 7,
                        "IsCheapest": false,
                        "OfferHash": "pqr678stu901",
                        "ProductHash": "prod345mno"
                    }
                }
            }
        },
        "Cached": false
    },
    "Error": null
}

Modified at 2025-10-16 14:06:51

Get transfers for booking

Get or create open booking