Book & Go Developer Resources

Integrate with Book & Go's public lead and scheduling API. Build AI agents that help users evaluate and connect with our white-label booking platform.

Quickstart

Book & Go provides unauthenticated, CORS-enabled public endpoints for AI agents and developers to submit leads or schedule demos on behalf of human users evaluating the platform.

⚠️ Important: Human Confirmation Required

Always confirm the request payload with the human user before submitting. These endpoints send emails and create calendar events.

How AI Agents Discover Resources

Agent fetches /llms.txt or /.well-known/api-catalog
Agent reads /openapi.json to understand available endpoints
Agent confirms request details with the human (name, email, club info, etc.)
Agent submits the request via POST to the appropriate endpoint
User receives confirmation email with next steps

Public API Endpoints

All endpoints are unauthenticated and require only a valid JSON payload. CORS is enabled for browser-based agents.

POST /api/quote-request

Submit a pricing quote request for a sports venue. The Book & Go team will follow up via email within 24 hours with a custom quotation.

Required fields:

name - Full name of the contact person
email - Valid email address
sports - Array of sports (padel, tennis, pickleball, fitness, wellness, gym, multi-sport)

POST /api/contact

Send a free-form message to the Book & Go team for general inquiries or questions.

Required fields:

name - Full name
email - Valid email address
message - Message content

POST /api/brochure-request

Email the Book & Go product brochure PDF to the provided email address.

Required fields:

name - Full name
email - Valid email address
interests - Array of sports

POST /api/scheduling/request-demo

Request a demo meeting with the Book & Go team. A team member will follow up within 24 hours to confirm a time.

Required fields:

name - Full name
email - Valid email address
phone - Phone number with country code

Error Handling

All error responses are returned as structured JSON with actionable hints for resolution.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: name, email",
    "hint": "Ensure all required fields are present in your request body.",
    "docs": "https://www.bookandgo.app/en/developers"
  }
}

Common error codes:

METHOD_NOT_ALLOWED - HTTP method not supported (use POST or OPTIONS)
INVALID_JSON - Request body is not valid JSON
MISSING_FIELDS - Required fields are missing from the request
INVALID_EMAIL - Email address format is invalid
INTERNAL_ERROR - Server-side error (safe to retry)

Machine-Readable Resources

OpenAPI Specification

Complete OpenAPI 3.1.0 spec for all public endpoints with request/response schemas.

/openapi.json

Documentation (llms.txt)

Lightweight product documentation optimized for AI systems and language models.

/llms.txt

Full Documentation

Comprehensive product reference with detailed feature descriptions and use cases.

/llms-full.txt

API Catalog

Well-known API catalog listing all public Book & Go endpoints.

/.well-known/api-catalog

MCP Server Card

Model Context Protocol server metadata for Book & Go integrations.

/.well-known/mcp/server-card.json

Agent Skills

Cursor Agent skills manifest for Book & Go API integrations.

/.well-known/agent-skills/index.json

Sitemap

Complete sitemap index for all Book & Go pages across all locales (en, es, pt, fr, de).

/sitemap.xml

Authentication & Access

The public lead and scheduling endpoints are unauthenticated and designed for AI agents to submit requests on behalf of human users evaluating Book & Go.

ℹ️ No API Keys or Sandbox Environment

Book & Go does not currently offer a self-serve API key product or sandbox environment for these public endpoints. They are designed for lightweight, human-confirmed lead generation and demo scheduling.

For club-specific booking APIs or advanced integrations, please contact our team to discuss custom solutions.

Need Help?

Have questions about integrating with Book & Go? Want to discuss custom API solutions or club-specific booking APIs? Our team is here to help.

Contact Support Schedule a Demo