AI Access

Utah Tee Times Agent API

Readable API documentation for agents and search engines that need to discover Utah tee-time inventory by location, date, time window, player count, holes, price, course, and provider.

Canonical API Host

The canonical API host is https://api.utahteetime.com. The machine-readable OpenAPI document is available at https://api.utahteetime.com/.well-known/openapi.json.

Search Tee Times by URL

Use GET /v1/tee-times/search with query parameters for a crawlable search URL. Supported parameters include lat, lng, radius_miles, date, time_start, time_end, players, holes, min_price, max_price, course_name, region, provider, limit, and sort.

GET https://api.utahteetime.com/v1/tee-times/search?lat=40.6097&lng=-111.9391&radius_miles=20&date=2026-04-30&time_start=14:30&time_end=15:30&players=2&holes=18

Search Tee Times by JSON

Use POST /v1/tee-times/search for structured JSON requests. Search returns stable tee-time ids, course metadata, ISO start times, IANA timezone, player availability, holes, price breakdowns, distance when location is supplied, and external booking URLs.

POST https://api.utahteetime.com/v1/tee-times/search
{
  "date": "2026-04-30",
  "location": {
    "lat": 40.6097,
    "lng": -111.9391,
    "radius_miles": 20
  },
  "time_window": {
    "start": "14:30",
    "end": "15:30"
  },
  "players": 2,
  "holes": [18],
  "limit": 10
}

Verify Before Booking

Use POST /v1/tee-times/verify with a tee_time_id from search results. Verification currently checks cached inventory and returns provider handoff instructions. Final checkout happens on the provider booking page.

POST https://api.utahteetime.com/v1/tee-times/verify
{
  "tee_time_id": "foreup|Riverbend Golf Course|2026-04-30|15:04|18"
}

Other Endpoints