List seasons

Returns the active seasons. Seasons managed by the Rate Calendar are not included.

The response has two formats:

Full (default). When you send none of season_id, date_from, date_to, include_rates, include_brand, include_full_brand and do not send paginate=1, the body is a JSON array of every season, each with its brand and all of its rates. This can be large. page, per_page and limit have no effect in this format.

Lightweight. When you send any of season_id, date_from, date_to, include_rates, include_brand, include_full_brand or paginate=1, seasons are ordered by updated_at and brand and rates are only included when you ask for them. Send include_rates=0 to get the lightweight list without anything else.

With paginate=1 the body is an object with success, the page details and the seasons in data; otherwise it is a JSON array ([] when nothing matches). The page URLs in the response (next_page_url, links, ...) contain only page: request the next page yourself with the same parameters (including paginate=1) and page + 1, up to last_page.

Boolean parameters take 1 or 0. true and false are rejected with 422.

Responses

🟢200OK

application/json

The seasons. Only the paginate=1 format has success; the other formats do not. HTTP 200 is also used for failures: such a body has success: false and is an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Examples

Full formatLightweight format with paginate=1

[
    {
        "id": 659,
        "brand_id": 1,
        "calendar_group_id": null,
        "name": "Winter 2027",
        "date_start": "2027-01-05T00:00:00.000000Z",
        "date_end": "2027-03-31T00:00:00.000000Z",
        "minimal_rental_period": 2,
        "max_rental_period": 30,
        "minimum_rental_hours": null,
        "maximum_rental_hours": null,
        "multiplier": null,
        "multiplier_per_rate_type": null,
        "minimal_rental_periods_per_class": null,
        "minimal_rental_periods_per_location": null,
        "active": true,
        "created_at": "2026-10-01T14:22:05.000000Z",
        "updated_at": "2026-10-01T14:22:05.000000Z",
        "brand": {
            "id": 1,
            "name": "Miami",
            "currency": "usd"
        },
        "rates": [
            {
                "id": 2650,
                "season_id": 659,
                "rate_type_id": null,
                "vehicle_class_id": 3,
                "minute_rate": null,
                "hourly_rate": "10.0000000",
                "daily_rate": "75.0000000",
                "weekly_rate": "0.0000000",
                "monthly_rate": "0.0000000",
                "decreasing_rates_based_on_intervals": false,
                "price_intervals": [],
                "decreasing_rates_based_on_intervals_hourly": false,
                "hourly_price_intervals": null,
                "decreasing_rates_based_on_intervals_per_minute": false,
                "per_minute_price_intervals": null,
                "locations": null,
                "tour_operators": null,
                "currency": "usd",
                "skip_season_multiplier": false
            }
        ]
    }
]

🟠422Parameter Error

Request

Responses