Skip to content
Docs

Profiles and slots

These endpoints are public and need no key. They are what the booking widget and slot picker call. :handle is the host's handle and :slug the event type's slug.

from and to accept a date or an instant. Slots come back grouped by day in the requested tz; each slot has a UTC start and end. To book one, send its start to Book a slot.

To reschedule a booking while excluding its own current slot from the busy time, pass booking and token (the manage token).

GET /public/:handle

A host’s profile and bookable event types. Auth: none.

Path parameters

FieldTypeRequiredDefault / limits
handlestringyes-

Response 200

Body

FieldTypeRequiredDefault / limits
hostobjectyes-
host.handlestringyes-
host.displayNamestringyes1–100 chars
host.timezonestringyesmin 1 chars
eventTypesobject[]yes-
eventTypes[].slugstringyes-
eventTypes[].titlestringyes1–120 chars
eventTypes[].descriptionstringyesdefault ""; max 2000 chars
eventTypes[].durationMinutesintegeryes5–720
eventTypes[].bufferBeforeMinutesintegeryesdefault 0; 0–240
eventTypes[].bufferAfterMinutesintegeryesdefault 0; 0–240
eventTypes[].minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
eventTypes[].maxPerDayinteger | nullyesdefault null
eventTypes[].locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
eventTypes[].locationValuestringyesdefault ""; max 500 chars
eventTypes[].kind"one_on_one" | "group"yesdefault "one_on_one"
eventTypes[].idstring (uuid)yes-
brandingbooleanyes-

Errors: not_found

curl -X GET "https://devalender.com/api/public/<handle>"

GET /public/:handle/:slug

One event type. Auth: none.

Path parameters

FieldTypeRequiredDefault / limits
handlestringyes-
slugstringyes-

Response 200

Body

FieldTypeRequiredDefault / limits
hostobjectyes-
host.handlestringyes-
host.displayNamestringyes1–100 chars
host.timezonestringyesmin 1 chars
eventTypeobjectyes-
eventType.slugstringyes-
eventType.titlestringyes1–120 chars
eventType.descriptionstringyesdefault ""; max 2000 chars
eventType.durationMinutesintegeryes5–720
eventType.bufferBeforeMinutesintegeryesdefault 0; 0–240
eventType.bufferAfterMinutesintegeryesdefault 0; 0–240
eventType.minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
eventType.maxPerDayinteger | nullyesdefault null
eventType.locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
eventType.locationValuestringyesdefault ""; max 500 chars
eventType.kind"one_on_one" | "group"yesdefault "one_on_one"
eventType.idstring (uuid)yes-
brandingbooleanyes-

Errors: not_found

curl -X GET "https://devalender.com/api/public/<handle>/<slug>"

GET /public/:handle/:slug/slots

Open slots between from and to, grouped by day in tz. Auth: none.

Path parameters

FieldTypeRequiredDefault / limits
handlestringyes-
slugstringyes-

Query parameters

FieldTypeRequiredDefault / limits
fromstring (date) | string (date-time)yes-
tostring (date) | string (date-time)yes-
tzstringnomin 1 chars
bookingstring (uuid)no-
tokenstringnomin 1 chars

Response 200

Body

FieldTypeRequiredDefault / limits
timezonestringyes-
daysobject[]yes-
days[].datestring (date)yes-
days[].slotsobject[]yes-
days[].slots[].startstring (date-time)yes-
days[].slots[].endstring (date-time)yes-

Errors: invalid_request, not_found

curl -X GET "https://devalender.com/api/public/<handle>/<slug>/slots?from=2030-01-07&to=2030-01-07"