Get Seasons

Retrieve pricing seasons for your account.

Endpoint

GET /v1/settings/seasons

Authentication

Requires an API key with the settings:read scope.

Response

Success (200 OK)

{
  "data": [
    {
      "id": 1,
      "name": "Peak Season",
      "type": "date",
      "start_date": "2026-06-01",
      "end_date": "2026-08-31",
      "date_ranges": [
        { "start_date": "2026-06-01", "end_date": "2026-08-31" },
        { "start_date": "2026-12-01", "end_date": "2026-12-20" }
      ],
      "start_time": null,
      "end_time": null,
      "days": {
        "sunday": true,
        "monday": true,
        "tuesday": true,
        "wednesday": true,
        "thursday": true,
        "friday": true,
        "saturday": true
      },
      "created_at": "2025-01-01T00:00:00+00:00",
      "updated_at": "2025-01-01T00:00:00+00:00"
    },
    {
      "id": 2,
      "name": "Weekend Rate",
      "type": "days",
      "start_date": null,
      "end_date": null,
      "date_ranges": [],
      "start_time": null,
      "end_time": null,
      "days": {
        "sunday": true,
        "monday": false,
        "tuesday": false,
        "wednesday": false,
        "thursday": false,
        "friday": true,
        "saturday": true
      },
      "created_at": "2025-01-01T00:00:00+00:00",
      "updated_at": "2025-01-01T00:00:00+00:00"
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
id	integer	Unique identifier
name	string	Season name
type	string	Season type: date, time, or days
start_date	string|null	Start date (YYYY-MM-DD) of the season's first date range. Kept for backward compatibility; equals date_ranges[0].start_date.
end_date	string|null	End date (YYYY-MM-DD) of the season's first date range. Kept for backward compatibility; equals date_ranges[0].end_date.
date_ranges	array	All date ranges a date season covers, ordered by start date. Each entry has start_date and end_date (YYYY-MM-DD). This is the authoritative list of when a date-based season applies. Empty array for time and days seasons.
start_time	string|null	Start time (HH:MM) for time-based seasons
end_time	string|null	End time (HH:MM) for time-based seasons
days	object	Days of week the season applies to
created_at	string	ISO 8601 datetime
updated_at	string	ISO 8601 datetime

Season Types

Type	Description
date	Applies during one or more date ranges
time	Applies during specific times of day
days	Applies on specific days of the week

Multiple date ranges

A date season can cover several date ranges — for example an early-season block and a holiday block that share the same rate. The full list of ranges is returned in date_ranges, and a booking date falls within the season if it lands inside any of those ranges.

Use date_ranges as the source of truth for date-based seasons. The top-level start_date and end_date remain for backward compatibility and always mirror the first range (date_ranges[0]); they do not describe any additional ranges. Seasons of type time or days cover no calendar ranges, so their date_ranges is an empty array.

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks settings:read scope

Example Request

curl -X GET "https://app.equipdash.com/api/v1/settings/seasons" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."