Skip to content
goldenhour
Back to help

API quick start

Curl your way through it

Goldenhour ships a public, no-auth-required API surface mostly used by AI agents. Below are curl examples for every endpoint, ready to paste into a terminal. Replace sobetan with your target tenant’s slug or UUID.

Reference docs

OpenAPI 3.1

/api/openapi.json

JSON Schema

/api/mcp/spec.json

llms.txt

/llms.txt

Curl examples

Nine endpoints, ready to paste

  1. Discover the platform

    Pull the platform-level MCP manifest. Lists every per-tenant endpoint shape.

    curl https://goldenhourhq.com/api/mcp/manifest

  2. Pull a specific tenant

    Get a single artist's business profile + public services. Works with slug OR account UUID.

    curl https://goldenhourhq.com/api/mcp/sobetan

  3. Check next 14 days of availability

    Returns one slot list per day; days where the artist isn't taking bookings have slots: [].

    curl 'https://goldenhourhq.com/api/mcp/sobetan/availability?service=01234567-89ab-cdef-0123-456789abcdef&days=14'

  4. Earliest single slot only

    Compact response: returns just the next available slot + a fully-formed booking URL.

    curl 'https://goldenhourhq.com/api/mcp/sobetan/availability/next?service=01234567-89ab-cdef-0123-456789abcdef'

  5. Get cancellation + hours + quiet hours

    Cancellation policy, business hours per day, no-show fee, service-area summary.

    curl https://goldenhourhq.com/api/mcp/sobetan/policies

  6. Get prose context for a system prompt

    Plain-text artist brief (~300-600 tokens). Drop straight into your LLM system prompt.

    curl https://goldenhourhq.com/api/mcp/sobetan/llm-context.txt

  7. Get the intake schema

    Per-tenant intake questions (key, label, type, required, conditional rules). Agents pre-collect during conversation.

    curl https://goldenhourhq.com/api/mcp/sobetan/intake-schema

  8. Generate a QR code

    Returns a PNG. Use ?size= (128-2048), ?fg= (hex), ?bg= (hex) for brand-matched output.

    curl -o sobetan-qr.png 'https://goldenhourhq.com/api/qr/sobetan?size=1024&fg=2A1730&bg=FCC861'

  9. Stable booking link (302)

    Use this URL anywhere: printed business cards, email signatures. Redirects to the artist's current canonical URL.

    curl -I https://goldenhourhq.com/api/booking-link/sobetan?utm_source=newsletter

Auth + rate limits

  • Auth: none required for the public surface. Everything above is intentionally unauthenticated.
  • CORS: every endpoint returns Access-Control-Allow-Origin: *. Agents on any host can read.
  • Rate limits: generous public-side. The only endpoint with explicit per-IP rate limiting is /api/book/quote-travel (30/min/IP); MCP endpoints have edge caches that absorb most agent polling.
  • User-Agent: please send a meaningful one. If you’re building an AI agent or app that integrates with goldenhour, including your product name helps us reach out if anything breaks.

Related: AI agents + MCP overview