Check availability dates
Days in one month that have openings for an appointment type.
GET https://cotlet.dev/api/v1/acuity-scheduling/appointment-types/{appointment_type_id}/availability-dates/check
read
Returns the dates in the month that have at least one open time for the appointment type, matching what clients see on your scheduler. Pass add-ons that belong to the type, because they change the openings. Call check_availability_times for the actual times on one of these dates.
Parameters
| Name | Type | Description |
|---|---|---|
| appointment_type_id integer required | integer | Appointment type ID from list_appointment_types. |
| month string required | string | Month to check, e.g. '2026-11'. |
| calendar_id integer | integer | Calendar ID from list_appointment_types or list_appointments. Without it, every calendar that offers the type is checked. |
| addon_ids integer[] | integer[] | Add-ons of this appointment type to include. |
| timezone string | string | Long-form timezone ID, e.g. 'America/New_York'. |
Request
curl "https://cotlet.dev/api/v1/acuity-scheduling/appointment-types/1/availability-dates/check?month=2026-11" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("acuity-scheduling", "check_availability_dates", {"appointment_type_id":1,"month":"2026-11"})const result = await cotlet.call('acuity-scheduling', 'check_availability_dates', {"appointment_type_id":1,"month":"2026-11"});cotlet call acuity-scheduling check_availability_dates --data '{"appointment_type_id":1,"month":"2026-11"}'Example response
{
"dates": [
"2026-11-03",
"2026-11-04",
"2026-11-05",
"2026-11-09"
]
}