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
| Field | Type | Required | Default / limits |
|---|---|---|---|
handle | string | yes | - |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
host | object | yes | - |
host.handle | string | yes | - |
host.displayName | string | yes | 1–100 chars |
host.timezone | string | yes | min 1 chars |
eventTypes | object[] | yes | - |
eventTypes[].slug | string | yes | - |
eventTypes[].title | string | yes | 1–120 chars |
eventTypes[].description | string | yes | default ""; max 2000 chars |
eventTypes[].durationMinutes | integer | yes | 5–720 |
eventTypes[].bufferBeforeMinutes | integer | yes | default 0; 0–240 |
eventTypes[].bufferAfterMinutes | integer | yes | default 0; 0–240 |
eventTypes[].minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
eventTypes[].maxPerDay | integer | null | yes | default null |
eventTypes[].locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
eventTypes[].locationValue | string | yes | default ""; max 500 chars |
eventTypes[].kind | "one_on_one" | "group" | yes | default "one_on_one" |
eventTypes[].id | string (uuid) | yes | - |
branding | boolean | yes | - |
Errors: not_found
curl -X GET "https://devalender.com/api/public/<handle>"GET /public/:handle/:slug
One event type. Auth: none.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
handle | string | yes | - |
slug | string | yes | - |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
host | object | yes | - |
host.handle | string | yes | - |
host.displayName | string | yes | 1–100 chars |
host.timezone | string | yes | min 1 chars |
eventType | object | yes | - |
eventType.slug | string | yes | - |
eventType.title | string | yes | 1–120 chars |
eventType.description | string | yes | default ""; max 2000 chars |
eventType.durationMinutes | integer | yes | 5–720 |
eventType.bufferBeforeMinutes | integer | yes | default 0; 0–240 |
eventType.bufferAfterMinutes | integer | yes | default 0; 0–240 |
eventType.minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
eventType.maxPerDay | integer | null | yes | default null |
eventType.locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
eventType.locationValue | string | yes | default ""; max 500 chars |
eventType.kind | "one_on_one" | "group" | yes | default "one_on_one" |
eventType.id | string (uuid) | yes | - |
branding | boolean | yes | - |
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
| Field | Type | Required | Default / limits |
|---|---|---|---|
handle | string | yes | - |
slug | string | yes | - |
Query parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
from | string (date) | string (date-time) | yes | - |
to | string (date) | string (date-time) | yes | - |
tz | string | no | min 1 chars |
booking | string (uuid) | no | - |
token | string | no | min 1 chars |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
timezone | string | yes | - |
days | object[] | yes | - |
days[].date | string (date) | yes | - |
days[].slots | object[] | yes | - |
days[].slots[].start | string (date-time) | yes | - |
days[].slots[].end | string (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"