HeyGuides
Partner API v1

Book guides from inside your own system.

Search verified guides, send a job, and get a named guide back — without leaving your itinerary tool. Authentication is a bearer key we issue you; writes require an Idempotency-Key so a retry can never book twice.

GET /v1/areas

Area ids, timezones, and whether each jurisdiction licenses guides at all.

GET /v1/guides

Search by area, dates, language and speciality. One price, already inclusive.

POST /v1/requests

Name a guide, or put the job to everyone who matches.

GET /v1/requests/{id}

Poll for the outcome and the confirmed guide's contact details.

Two things to know before you build: tour dates are calendar days in the area's own timezone, never timestamps; and availability: "unknown" means we know of no conflict, not that the guide is free.

Request access