Slots

Note

A Slot is a specific time (THH:MM:SSZ) on a specific date (YYYY-MM-DD) upon which a FacilityUse is available.

Once a FacilityUse By-ID or Slot By-ID search has been made, more information about a Slot will be presented by the API, including information like price and number of courts, pitches, etc. available. We refer to these as sportsActivityLocations.

maximumUses & remainingUses

A Slot relating to a specific FacilityUse might have one or more sportsActivityLocations available. For example, there might be 6 badminton courts in a sports hall, all of which are included within the same FactilityUse. In this instance:

• The total number of courts (6) is reflected in maximumUses;
• The number of courts still available is reflected in remainingUses; and
• The information about the courts still available is included within the beta:sportsActivityLocation array.

Caution

maximumUses refers to the total number of courts available for a specific FacilityUse and, as such, always remains the same. It does not account for courts that have been booked and does not serve to indicate the number of people who can attend.

Example

Looking at the JSON below you can see that there are 6 courts available (maximumUses) and that 2 of them have been booked, leaving 4 remainingUses. The beta:sportsActivityLocation[].name shows the courts that are still available.

"maximumUses": 6,
"remainingUses": 4,
"beta:sportsActivityLocation": [
    {
        "name": "Main Hall Court 1",
        "type": "SportsActivityLocation",
        "identifier": "188ZMHAL01"
    },
    {
        "name": "Main Hall Court 3",
        "type": "SportsActivityLocation",
        "identifier": "188ZMHAL03"
    },
    {
        "name": "Main Hall Court 4",
        "type": "SportsActivityLocation",
        "identifier": "188ZMHAL04"
    },
    {
        "name": "Main Hall Court 6",
        "type": "SportsActivityLocation",
        "identifier": "188ZMHAL06"
    }
],