Native booking availability api

Get available time slots for an appointment type

Returns the slot map bucketed by date in the requested timezone. The agent walks the map to learn what's bookable between start and end.

get/api/sites/multiscreen/{site_name}/booking/availability

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/booking/availability
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

Query parameters

appointment_type_idstring required
Example:01JZ83QB5MQFRMXWAVQ55C648W

Duda id of the appointment type to query availability for.

startstring required
Example:2026-06-01T00:00:00.000Z

Lower bound of the window to check, ISO 8601 UTC, inclusive.

endstring required
Example:2026-06-08T00:00:00.000Z

Upper bound of the window to check, ISO 8601 UTC, exclusive.

time_zonestring
Example:America/New_York

IANA timezone in which the returned slots should be bucketed (e.g. 'America/New_York'). Defaults to UTC when omitted.

durationinteger
Example:30

Override slot duration in minutes for variable-length event types.

Response

OK

slotsobject

Map of date string (YYYY-MM-DD in the requested timezone) to the slots open on that day.

time_zonestring

Timezone the returned slots are bucketed in. Defaults to UTC when the caller did not specify time_zone.

Example response

{
  "slots": {
    "2026-06-01": [
      {
        "start": "2026-06-01T09:00:00.000-04:00"
      }
    ]
  },
  "time_zone": "America/New_York"
}

Changes

No recorded changes to this operation across all 1 revision of this API.