---
title: "Get a paged array of practitioners"
method: GET
path: "/practitioners"
tags: ["practitioner"]
---

# Get a paged array of practitioners

`GET /practitioners`

Get a paged array of practitioners

## Query parameters

- `id_gt` integer, nullable — The starting object id of the next page
- `id_lt` integer, nullable — The starting object id of the previous page
- `update_gt` union — Search for objects updated after this date time
  - string
  - string
- `update_lt` union — Search for objects updated before this date time
  - string
  - string
- `include_archived` 'true' | 'false', nullable — Whether archived objects should be retrieved, default is false
- `firstname` string, nullable — Practitioner first name
- `lastname` string, nullable — Practitioner last name
- `email` string, nullable — Patient email
- `isActive` 'true' | 'false', nullable — Whether the practitioner is active
- `roleName` string, nullable — Practitioner role name – can be one of the predefined roles or a custom user-defined role

## Response `200`

A paged array of practitioners

- object
  - `data` object[], required
    - `id` integer, required — Practitioner id
    - `firstname` string, required — Practitioner first name
    - `lastname` string, required — Practitioner last name
    - `email` string, email, nullable, required — Practitioner email
    - `title` string, nullable, required — Practitioner title
    - `profession` string, nullable, required — Practitioner profession
    - `isActive` boolean, nullable — Whether the practitioner is active
    - `description` string, nullable, required — Practitioner description
    - `roleName` string, required — Practitioner role name – can be one of the predefined roles or a custom user-defined role
    - `onlineBooking` boolean, nullable — Whether online booking is enabled
    - `timezone` string, nullable — Practitioner timezone
    - `connections` object[], required — Array of practitioner connections (locations/services) associated with this practitioner
      - `typeId` integer, required — Item type id
      - `type` 'Location' | 'Service', required — Item type
    - `providerNumbers` object[], required
      - `type` string, required — Provider number type
      - `number` string, required — Provider number
      - `locationId` integer, nullable, required — The location of this provider number
    - `archived` boolean, nullable — Whether the practitioner has been archived
    - `createdAt` union — Object creation date time
      - string
      - string
    - `updatedAt` union — Object update date time
      - string
      - string
    - `deletedAt` union, required — Object archived date time
      - string
      - string
      - unknown
  - `links` object, required
    - `previousPage` string — The link to retrieve next page
    - `nextPage` string — The link to retrieve previous page

---

[API](https://skmtc.dev/splose/apis/splose-public-api.md) · [All operations](https://skmtc.dev/splose/apis/splose-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/splose/splose-public-api/revisions/648d60075f00/schema)