---
title: "Get available appointment slots for a date"
method: GET
path: "/public/widget/clinics/{clinicId}/slots"
tags: ["Widget"]
---

# Get available appointment slots for a date

`GET /public/widget/clinics/{clinicId}/slots`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/public/widget/clinics/{clinicId}/slots`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/public/widget/clinics/:clinicId/slots/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `clinicId` string, required

## Query parameters

- `date` string, date-time
- `appointmentType` string
- `locationId` string
- `appointmentTypeId` string

## Response `200`

Available appointment slots

- GetAvailableSlotsResponse
  - `slots` AvailableSlotDto[]
    - `id` string
    - `startTime` string, date-time
    - `endTime` string, date-time
    - `providerId` string, nullable
    - `providerName` string, nullable
    - `locationId` string, nullable
    - `locationName` string, nullable
  - `date` string, date-time

## Changes

- **2026-08-26** `a57456aa87b0`: 1 info
  - added the new optional `query` request parameter `appointmentTypeId`

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/public/widget/clinics/:clinicId/slots/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)