Tee Times

TeeTime availability

List Tee Times

GET /api/v5/teetimes/{facilityId}/{courseId}
  • Path Parameters

    • facilityId: e.g. 2 (Integer, required) - ID of the facility
    • courseId: e.g. 7 (Integer, required) - ID of the course
  • Query Parameters

    • bookingDate: e.g. 19-03-2023 (string, required) - Date
    • players: e.g. 4 (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/v5/teetimes/2/7/?bookingDate=19-03-2023&players=4&holes=18'
  • Successful Response (application/json)
    {
        "success": true,
        "data": {
            "teeTimeV3": [
                {
                    "teeid": 38766,
                    "time": "2023-03-19T09:00:00",
                    "course": "18 holes",
                    "holes": 18,
                    "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"
                              }
                          }
                    ],
                    "products": [
                        {
                            "mid": 42,
                            "name": "multiple-rate",
                            "category": "Greenfee",
                            "available": 4,
                            "pricing": [
                                {
                                    "quantity": 1,
                                    "price": {
                                        "amount": 50,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 45,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 50,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 2,
                                    "price": {
                                        "amount": 110,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 99,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 110,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 3,
                                    "price": {
                                        "amount": 180,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 162,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 180,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 4,
                                    "price": {
                                        "amount": 260,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 234,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 260,
                                        "currency": "EUR"
                                    }
                                }
                            ],  
                            "players": null,
                            "linkedProducts": []
                        },
                        {
                            "mid": 39,
                            "name": "p3",
                            "category": "Greenfee",
                            "available": 4,
                            "pricing": [
                                {
                                    "quantity": 1,
                                    "price": {
                                        "amount": 45,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 40.5,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 45,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 2,
                                    "price": {
                                        "amount": 100,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 90,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 100,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 3,
                                    "price": {
                                        "amount": 165,
                                        "currency": "EUR"
                                    },
                                    "netRate": {
                                        "amount": 148.5,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 165,
                                        "currency": "EUR"
                                    }
                                },
                                {
                                    "quantity": 4,
                                    "price": {
                                        "amount": 240,
                                        "currency": "EUR"
                                    },  
                                    "netRate": {
                                        "amount": 216,
                                        "currency": "EUR"
                                    },
                                    "publicRate": {
                                        "amount": 240,
                                        "currency": "EUR"
                                    }
                                }
                            ],
                            "players": null,
                            "linkedProducts": []
                        }
                    ]
                }
            ],
            "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.