Welcome to the home of the GolfNow API, an easy to use reservation and booking service that makes it easy to find courses, tee times, and make reservations. It provides resources to GolfNow partners and affiliate golf courses to integrate their websites and mobile apps with this reservation and booking service for searching and booking tee times at all GolfNow affiliated golf courses.

Requesting Access

First things first, you will need access to the API. The development API endpoint is located at https://sandbox.api.gnsvc.com/rest and access can be granted by clicking here.

Client Authentication

Two methods are available for client authentication: Simple Authentication and authentication using an Authorization Signature.

Simple Authentication

For simple authentication, just pass in your API client's assigned UserName and Password request headers with your assigned UserName and Password.
The following is a sample request using simple authentication:

Authorization Signature

To use the more secure Authorization signature, you must generate an Authorization signature using your assinged UserName, Password and ClientApplicationSecret, plus a Unix Timestamp representing the current date and time in UTC. For security purposes, the timestamp is valid for only one minute and will be rejected if it is older than one minute.

The generated Authorization signature is passed in as the "Authorization" http header, along with the "Timestamp" header, which is used to pass in the timestamp used to generate the Authorization string.

The Authorization signature is created by HMAC-256 signing the following string concatenation, using your assigned ClientApplicationSecret as the key, and Base64 encoding the results:

Username + SHA1-Hashed Password as Base64-encoded string + UTC Timestamp

Click here for more detailed instructions and code samples.

The following is a sample request using the Timestamp and Authorization headers:

Hello World

The following sample demonstrates a successful hello world request to the GolfNow API.

Getting Tee Times

The following code sample will get facilities and tee times near a specified geo-location.

Authenticating A Customer

Continuation Token

When the client makes an API call that uses a customer token, the API will respond with a new customer token that can be used for a specified time period after the use of the first token. This new token will be in the response headers as 'CustomerToken'. The client can specify the timeout in minutes of this new token by using a 'CustomerTokenTimeout' header value in the request. The maximum timeout value is 15 minutes.