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 sobetanwith your target tenant’s slug or UUID.
Reference docs
Curl examples
Nine endpoints, ready to paste
Discover the platform
Pull the platform-level MCP manifest. Lists every per-tenant endpoint shape.
curl https://goldenhourhq.com/api/mcp/manifestPull a specific tenant
Get a single artist's business profile + public services. Works with slug OR account UUID.
curl https://goldenhourhq.com/api/mcp/sobetanCheck 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'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'Get cancellation + hours + quiet hours
Cancellation policy, business hours per day, no-show fee, service-area summary.
curl https://goldenhourhq.com/api/mcp/sobetan/policiesGet 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.txtGet 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-schemaGenerate 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'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.