---
title: "List bookings"
method: GET
path: "/bookings"
tags: ["Booking"]
---

# List bookings

`GET /bookings`

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string[]
- `order` 'asc' | 'desc'
- `q[]` string[]

## Response `200`

successful operation

- object
  - `bookings` Booking[]
    - union
      - object
        - `appointment_type` object
          - `links` object
            - `self` string, uri
        - `archived_at` string, date-time, nullable
        - `attendees` object
          - `links` object
            - `self` string, uri
        - `business` object
          - `links` object
            - `self` string, uri
        - `conflicts` object, nullable
          - `links` object
            - `self` string, uri
        - `created_at` string, date-time
        - `deleted_at` string, date-time, nullable
        - `ends_at` string, date-time
        - `id` string, int64
        - `links` object
          - `self` string, uri
        - `max_attendees` integer
        - `notes` string, nullable
        - `patient_ids` string[], nullable
        - `practitioner` object
          - `links` object
            - `self` string, uri
        - `repeat_rule` object, nullable
          - `number_of_repeats` integer, nullable
          - `repeat_type` 'Daily' | 'Monthly' | 'Weekly', nullable
          - `repeating_interval` integer, nullable
        - `repeated_from` object
          - `links` object
            - `self` string, uri
        - `repeats` object, nullable
          - `links` object
            - `self` string, uri
        - `starts_at` string, date-time
        - `telehealth_url` string, uri, nullable
        - `updated_at` string, date-time
      - object
        - `appointment_type` object
          - `links` object
            - `self` string, uri
        - `archived_at` string, date-time, nullable
        - `attendees` object
          - `links` object
            - `self` string, uri
        - `booking_ip_address` string, ipv4, nullable
        - `business` object
          - `links` object
            - `self` string, uri
        - `cancellation_note` string, nullable
        - `cancellation_reason` integer, nullable
        - `cancellation_reason_description` 'Feeling Better' | 'Condition Worse' | 'Sick' | 'COVID-19 related' | 'Away' | 'Other' | 'Work', nullable
        - `cancelled_at` string, date-time, nullable
        - `conflicts` object, nullable
          - `links` object
            - `self` string, uri
        - `created_at` string, date-time
        - `deleted_at` string, date-time, nullable
        - `did_not_arrive` boolean, nullable
        - `email_reminder_sent` boolean, nullable
        - `ends_at` string, date-time
        - `has_patient_appointment_notes` boolean, nullable
        - `id` string, int64
        - `invoice_status` integer, nullable
        - `links` object
          - `self` string, uri
        - `notes` string, nullable
        - `online_booking_policy_accepted` boolean, nullable
        - `patient` object
          - `links` object
            - `self` string, uri
        - `patient_arrived` boolean, nullable
        - `patient_case` object
          - `links` object
            - `self` string, uri
        - `patient_name` string, nullable
        - `practitioner` object
          - `links` object
            - `self` string, uri
        - `repeat_rule` object, nullable
          - `number_of_repeats` integer, nullable
          - `repeat_type` 'Daily' | 'Monthly' | 'Weekly', nullable
          - `repeating_interval` integer, nullable
        - `repeated_from` object
          - `links` object
            - `self` string, uri
        - `repeats` object, nullable
          - `links` object
            - `self` string, uri
        - `sms_reminder_sent` boolean, nullable
        - `starts_at` string, date-time
        - `telehealth_url` string, uri, nullable
        - `treatment_note_status` integer, nullable
        - `updated_at` string, date-time
      - object
        - `archived_at` string, date-time, nullable
        - `business` object
          - `links` object
            - `self` string, uri
        - `conflicts` object, nullable
          - `links` object
            - `self` string, uri
        - `created_at` string, date-time
        - `deleted_at` string, date-time, nullable
        - `ends_at` string, date-time
        - `id` string, int64
        - `links` object
          - `self` string, uri
        - `notes` string, nullable
        - `practitioner` object
          - `links` object
            - `self` string, uri
        - `repeat_rule` object, nullable
          - `number_of_repeats` integer, nullable
          - `repeat_type` 'Daily' | 'Monthly' | 'Weekly', nullable
          - `repeating_interval` integer, nullable
        - `repeated_from` object
          - `links` object
            - `self` string, uri
        - `repeats` object, nullable
          - `links` object
            - `self` string, uri
        - `starts_at` string, date-time
        - `unavailable_block_type` object
          - `links` object
            - `self` string, uri
        - `updated_at` string, date-time
  - `total_entries` integer
  - `links` object
    - `self` string, uri
    - `previous` string, uri
    - `next` string, uri

---

[API](https://skmtc.net/cliniko/apis/cliniko-api.md) · [All operations](https://skmtc.net/cliniko/apis/cliniko-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cliniko/cliniko-api/revisions/ffc3ab3f8ea0/schema)