---
title: "List all appointment kinds"
method: GET
path: "/ext/v2/appointment-kinds/"
tags: ["Scheduler"]
---

# List all appointment kinds

`GET /ext/v2/appointment-kinds/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/appointment-kinds/`
- Auth: HTTP bearer

Returns a list of all appointment kinds defined at the organization level. The appointment kinds are sorted by creation date, with the most recent appearing first.

An **appointment kind** defines a type of appointment (e.g., wellness exam, vaccination, surgery, dental cleaning) and is used when creating or categorizing appointments.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.

## Response `200`

OK

- AppointmentKindList
  - `data` ExternalAppointmentKindSchema[], required: A single page of data contained within this list.
    - `color` union, required: Color for the AppointmentKind.
      - 'SLATE' | 'RED' | 'POMEGRANATE' | 'ORANGE' | 'AMBER' | 'YELLOW' | 'LIME' | 'GREEN' | 'EMERALD' | 'TEAL' | 'CYAN' | 'SKY' | 'BLUE' | 'INDIGO' | 'VIOLET' | 'PURPLE' | 'FUCHSIA' | 'PINK' | 'WATERMELON' | 'ROSE'
      - ''
    - `created` string, date-time, required: The datetime this object was created.
    - `description` string, nullable, required: Description of the appointment kind.
    - `id` integer, required: The unique identifier for the appointment kind.
    - `includes_pickup_and_dropoff` boolean, required: Whether appointments of this kind require a dropoff and pickup.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `name` string, required: Display name for the appointment kind.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)
