Appointment Times (Deprecated)

**DEPRECATED** This endpoint is no longer supported, it has been replaced by the availability times endpoint, which provides a more flexible way to retrieve times available for appointments. This endpoint returns two different payloads depending on the presence of the time query parameter. Without time, this endpoint returns all possible appointment times today regardless of actual agent availability (group's office hours). If time is passed in (an ISO format datetime), this endpoint returns only timeslots where at least one agent is available to give a tour.

GET

/api/v2/appointments/group/:group_id/times

Response

Example response (without time query parameter)JSON200 · application/json

{
  "available_times": [
    "08:00:00",
    "08:15:00",
    "08:30:00",
    "08:45:00",
    "09:00:00",
    "09:15:00",
    "09:30:00",
    "09:45:00",
    "10:00:00",
    "10:15:00",
    "10:30:00",
    "10:45:00",
    "11:00:00",
    "11:15:00",
    "11:30:00",
    "11:45:00",
    "12:00:00",
    "12:15:00",
    "12:30:00",
    "12:45:00",
    "13:00:00",
    "13:15:00",
    "13:30:00",
    "13:45:00",
    "14:00:00",
    "14:15:00",
    "14:30:00",
    "14:45:00",
    "15:00:00",
    "15:15:00",
    "15:30:00",
    "15:45:00",
    "16:00:00",
    "16:15:00",
    "16:30:00",
    "16:45:00",
    "17:00:00",
    "17:15:00",
    "17:30:00",
    "17:45:00",
    "18:00:00",
    "18:15:00",
    "18:30:00",
    "18:45:00",
    "19:00:00",
    "19:15:00",
    "19:30:00"
  ],
  "valid": true,
  "errors": {},
  "appointment_sms_opt_in": true
}

⚠️

A 400 here doesn't necessarily mean the request was malformed

This endpoint returns HTTP 400 (with the same body shape shown above) whenever valid is false or available_times is empty — even if the request itself was perfectly well-formed. An empty result (no available times for the day) is enough to trigger a 400. Check the response body's valid and available_times fields rather than assuming a 400 means your request was invalid.

ℹ️

Errors common to all appointment endpoints

This endpoint can also return the Employee Group Not Found (404) and Employee Group Not Active (400) errors, checked before any endpoint-specific validation runs. See Errors common to all appointment endpoints.