Tee Times

TeeTime availability

List Tee Times

GET /api/v3/teetimes/{facilityId}

• Path Parameters

  • facilityId: e.g. 1 (Integer, required) - ID of the facility

• Query Parameters

  • bookingDate: e.g. 30-12-2017 (string, required) - Date
  • players: e.g. 2 (Integer, required) - Number of free slots required (between 1 and 4)
  • holes: e.g. 9 (Integer, required) - Number of holes (9 or 18)

This can be done with a curl command like so :

$curl -X GET -H 'Content-Type:application/json'  --user [[username]]:[[password]] '[[base-url]]/api/v3/teetimes/2/?bookingDate=20-08-2018&players=4&holes=18'

• Successful Response (application/json)

  {
      "success": true,
      "data": {
          "teeTimeV2": [
              {
                  "id": 38766,
                  "time": "2023-03-19T09:00:00",
                  "course": "18 holes",
                  "holes": 18,
                  "players": 4,
                  "extraProducts": [
                        {
                            "mid": 274,
                            "name": "New Extra Transfer Product",
                            "category": "Transfer",
                            "price": {
                                "amount": 15,
                                "currency": "EUR"
                            },
                            "netRate": {
                                "amount": 15,
                                "currency": "EUR"
                            },
                            "publicRate": {
                                "amount": 20,
                                "currency": "EUR"
                            }
                        },
                        {
                            "mid": 259,
                            "name": "buggy trail 2",
                            "category": "Buggy",
                            "price": {
                                "amount": 11.5,
                                "currency": "EUR"
                            },
                            "netRate": {
                                "amount": 10,
                                "currency": "EUR"
                            },
                            "publicRate": {
                                "amount": 100,
                                "currency": "EUR"
                           }
                        }
                  ],
                  "pricing": [
                      {
                          "players": "1",
                          "price": {
                              "amount": 10,
                              "currency": "GBP"
                          }
                      },
                      {
                          "players": "2",
                          "price": {
                              "amount": 20,
                              "currency": "GBP"
                          }
                      },
                      {
                          "players": "3",
                          "price": {
                              "amount": 30,
                              "currency": "GBP"
                          }
                      },
                      {
                          "players": "4",
                          "price": {
                              "amount": 40,
                              "currency": "GBP"
                          }
                      }
                  ]   
              }
          ],
          "facilityCancellationPolicyRange": [
              {
                  "minimumPlayer": 1,
                  "maximumPlayer": 4,
                  "timePeriod": 24
              }
          ]
      }
  }
  

The cancellation policy is defined by the facility in the booking rule under the agreement policy. Channels can access and view the applicable cancellation policy in the tee time response under the heading facilityCancellationPolicyRange.

Below is a sample representation of the cancellation policy:

"facilityCancellationPolicyRange": [
  {
    "minimumPlayer": 1,
    "maximumPlayer": 4,
    "timePeriod": 48
  },
  {
    "minimumPlayer": 5,
    "maximumPlayer": 10,
    "timePeriod": 24
  }
]

Explanation:
TimePeriod: The time period is expressed in hours.

Example:
For bookings made for 1 to 4 players, cancellations are allowed up to 48 hours before the tee time.
For bookings made for 5 to 10 players, cancellations are allowed up to 24 hours before the tee time.

Note: If a cancellation request is made in violation of the cancellation policy, the request will be denied.