Find bookable slots for an appointment type over a date range.

GEThttps://app.softsolz.uk/api/v1/services/appointments/availability

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Query Params

type_idintegerrequired

Appointment type to check. Required.

fromstringrequired

Start of the search range, ISO date or timestamp. Required.

tostringrequired

End of the search range, ISO date or timestamp. Required.

resource_idinteger

Restrict to one resource. Omit to search every qualifying resource.

timezonestring

IANA timezone to render slots in. Defaults to the workspace timezone.

Response

Response Body

timezonestringIANA timezone, for example Europe/London.

slotsarray of objectsBookable slots in the requested range.

Request

curl --request GET \
  --url 'https://app.softsolz.uk/api/v1/services/appointments/availability?type_id={type_id}&from={from}&to={to}' \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Authorization

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": {
    "timezone": "Europe/London",
    "slots": [
      {
        "starts_at": "2027-03-01T10:00:00.000Z",
        "ends_at": "2027-03-01T11:00:00.000Z",
        "window_ends_at": "2026-01-01T09:00:00.000Z",
        "resource_ids": [
          3
        ],
        "places_remaining": null
      }
    ]
  }
}