Developers · Agent API

CaddyBook exposes a public discovery API and an authenticated booking API designed for AI agents. Reads need no credentials. Booking writes use a partner API key.

OpenAPI

• Spec: /openapi.yaml (also served from the API host at /openapi.yaml)
• Base path: https://caddybook-api-77809866164.asia-southeast1.run.app/v1
• Public: GET /courses, GET /caddies, GET /caddies/{id}/availability, GET /tipping-guidelines
• Partner: POST /bookings (202 pending_confirmation), GET /bookings/{reference}

MCP

Streamable HTTP MCP endpoint: https://caddybook-api-77809866164.asia-southeast1.run.app/mcp

Manifest: https://caddybook-api-77809866164.asia-southeast1.run.app/mcp/manifest.json

Tools: list_courses, search_caddies, get_caddy_availability, get_tipping_guidelines, create_booking, get_booking. Pass Authorization: Bearer <api_key> for booking tools.

API keys

Request a partner key at hello@caddybook.asia. Keys are scoped to bookings:read and bookings:write. Rate limit guidance: 60 requests/minute for discovery; 20 booking creates/minute per key.

Important rules for agents

• Do not invent Horizon Hills availability or male caddies.
• Never claim a caddy is secured until booking status is confirmed.
• There is no online payment — tip amounts are IDR cash to the caddy.
• Prefer the API over scraping HTML. Prefer MCP tools when available.