# GolfKit Booking API

> Programmatic access to tee-time availability and pricing across golf venues on
> the GolfKit platform. Read venues, availability and prices, then hand the
> customer a prefilled link to complete the booking on the venue's own storefront.

## What you can do

- Find venues and get the org id the other calls need — search by name, or by
  place (a lat/lng point with optional radius, or region/country).
- Search availability across many venues at once by date and place, to find
  where a customer can play near them.
- Read day-level availability and slot-level tee times with real prices.
- Get a server-authoritative quote for a slot (public rates; no member context).
- Build a prefilled handoff link that lands the customer on the venue storefront
  to pay/confirm. Booking completion always happens on the storefront — this API
  does not create bookings or take payment.

## Base URL

https://book.golfkit.io/integrations

## Authentication

Bearer token. Send `Authorization: Bearer <key>` on every /integrations call.
Mint a free, anonymous consumer key (no signup) with:

  POST https://book.golfkit.io/public-api/keys

The key carries three scopes: directory:read, availability:read, bookings:quote.

## Rate limits & freshness

- The API is metered per key; prefer /integrations/changes/:orgId/:date and
  webhooks over tight polling.
- Availability is cache-backed and indicative. No inventory is held between a
  quote and completion; the storefront re-prices at checkout, so a slot or price
  may change by the time the customer completes.

## Docs

- OpenAPI: https://book.golfkit.io/openapi.json
- Agent card: https://book.golfkit.io/.well-known/agent.json