Skip to Content
TillorManual
Organization settings

List opening hours for a date or range

Acesso

Membro da organização com pelo menos uma destas permissões:

  • organization:settings:read
  • organization:settings:write

Uma chave de API com scopes também precisa da permissão nos seus scopes.

GET
/orgs/{organizationId}/organization-settings/opening-hours

Resolves published opening hours for one civil date (date) or an inclusive range (from and to, max 366 days). Omit the dates to use today in the organization timezone. Exceptions override seasonal periods, which override the regular weekly hours. Public holidays overlapping the range are included (holidays and items[].holiday). Optional languageIsoCode localizes holiday names. Requires organization:settings:read or organization:settings:write.

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

Query Parameters

date?string
Match^\d{4}-\d{2}-\d{2}$
from?string
Match^\d{4}-\d{2}-\d{2}$
to?string
Match^\d{4}-\d{2}-\d{2}$
languageIsoCode?string
Length2 <= length <= 3

Response Body

Resolved opening hours and public holidays for each requested date

application/json
  1. response
timeZone*string
from*string
Match^\d{4}-\d{2}-\d{2}$
to*string
Match^\d{4}-\d{2}-\d{2}$
holidays*array<>
items*array<>
Example Request
curl -X GET 'https://api.tillor.eu/orgs//organization-settings/opening-hours'
Example Response
{  "timeZone": "string",  "from": "string",  "to": "string",  "holidays": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "startDate": "string",      "endDate": "string"    }  ],  "items": [    {      "date": "string",      "weekday": "monday",      "source": "exception",      "periodLabel": "string",      "holiday": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "startDate": "string",        "endDate": "string"      },      "blocks": [        {          "startMinutes": 0,          "endMinutes": 0        }      ],      "closed": true,      "notice": true    }  ]}

Get the terrain tariff formula GET

Returns the TypeScript formula that calculates a terrain's annual tariff. Available to every organization member, since occupation prices derive from it; it is edited through PATCH /organization-settings.

Get the opening hours overview GET

Everything a website needs to show opening hours: the regular week and every seasonal period as weekly schedules (`schedules`, the one that applies today marked `current`), and the dates from today through the next six days that deviate from their weekly schedule (`upcoming`): an exception that changes the hours, or a public holiday the park is open on. An exception that matches the normal hours, such as closed on an already closed Sunday, is not listed. Optional `languageIsoCode` localizes holiday names. Requires organization:settings:read or organization:settings:write.