Get available appointment slots

Fetches available appointment time slots and any existing appointment for the presentation viewer. Slots are grouped by date in the prospect’s timezone.

Authentication: Requires a presentation token in the x-presentation-token header (not a session cookie).

Rate limit: 30 requests per minute per presentation.

GET /api/presentations/{presentationId}/appointment

Get available appointment slots

cURL

curl --request GET \
  --url https://app.demand-iq.com/api/presentations/{presentationId}/appointment \
  --header 'x-presentation-token: <x-presentation-token>'

200

{
  "slotsByDate": {},
  "appointmentLength": 60,
  "timezone": "America/Denver",
  "existingAppointment": {
    "startTime": "2023-11-07T05:31:56Z",
    "endTime": "2023-11-07T05:31:56Z"
  },
  "prospectEmail": "[e-mail]",
  "prospectPhone": "<string>"
}

Headers

x-presentation-token · string · required

Presentation authentication token

Path Parameters

presentationId · string<uuid> · required

Response

200

application/json

Available slots and existing appointment

slotsByDate · object

Available time slots grouped by date (YYYY-MM-DD keys)

Show child attributes

appointmentLength · integer

Appointment duration in minutes

Example:

60

timezone · string

IANA timezone for the prospect

Example:

"America/Denver"

existingAppointment · object

The prospect's existing appointment, if any

Show child attributes

prospectEmail · string<email> | null

prospectPhone · string | null