VEvetcove
Scheduler

List all appointments

Returns a list of all appointments across all clinics in the organization. The appointments are sorted by creation date, with the most recent appointments appearing first.

An appointment represents a scheduled visit for a clinic patient at a clinic, tracking its lifecycle from request through completion or cancellation.

get/ext/v2/appointments/

Request

  • Base URL
    https://connect.vetcove.com
  • URL
    https://connect.vetcove.com/ext/v2/appointments/
  • Auth
    HTTP bearer

Query parameters

idsinteger[] nullable

When provided, filters to objects with these IDs.

ending_beforeinteger 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_afterinteger 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.

limitinteger

The maximum number of items to return per page.

cursorstring nullable

A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with starting_after or ending_before parameters.

modified__gtestring date-time nullable

Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with starting_after or ending_before parameters.

modified__ltestring date-time nullable

Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with starting_after or ending_before parameters.

is_deleted'FALSE' | 'TRUE' | 'ALL'

When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.

clinic_client_idinteger nullable

When provided, filters to appointments for the clinic client with this ID

clinic_patient_idinteger nullable

When provided, filters to appointments for the clinic patient with this ID

clinic_idinteger nullable

When provided, filters to appointments for the clinic with this ID

status'CREATING' | 'CLIENT_CREATING' | 'UNSCHEDULED' | 'UNCONFIRMED' | 'CONFIRMED' | 'DROPPED_OFF' | 'CHECKED_IN' | 'IN_PROGRESS' | 'READY_TO_GO' | 'COMPLETED' | 'NO_SHOW' | 'CANCELED' | 'IMPORTED' | 'CLIENT_REQUESTED'

When provided, filters to appointments with this status.

resource_idinteger nullable

When provided, filters to appointments assigned to the calendar resource with this ID.

end_datetime__ltestring date-time nullable

When provided, filters to appointments ending on or before this datetime. If both end_datetime__lte and start_datetime__gte are provided, end_datetime__lte must be greater than start_datetime__gte.

start_datetime__gtestring date-time nullable

When provided, filters to appointments starting on or after this datetime. If both end_datetime__lte and start_datetime__gte are provided, end_datetime__lte must be greater than start_datetime__gte.

Response

OK

has_moreboolean

Whether there are more pages or data in this list.

next_pagestring required

A URL linking to the next page of this list.

typestring

Type of this object. Always list.

Changes

No recorded changes to this operation across all 1 revision of this API.