--- title: "List all clinics" method: GET path: "/ext/v2/clinics/" tags: ["Clinics"] --- # List all clinics `GET /ext/v2/clinics/` ## Request - Base URL: `https://connect.vetcove.com` - URL: `https://connect.vetcove.com/ext/v2/clinics/` - Auth: HTTP bearer Returns a list of all clinics in the organization. The clinics are sorted by creation date, with the most recent clinics appearing first. When using modified filters, results are sorted in descending modification date instead. A **clinic** represents a single veterinary clinic location. An organization (clinic group) can have many clinics. Each clinic has its own clients, patients, and operational data. ## 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. - `cursor` string, 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__gte` string, 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__lte` string, 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. - `group_location_codes` string[], nullable: When provided, filters to clinics for the list of group location codes. Group location codes are a group's internal identifier for their clinics. - `is_pims` boolean, nullable: When `True`, filters to PIMS-enabled clinics. When `False`, filters to non-PIMS clinics. When `None`, then both are included. ## Response `200` OK - ClinicList - `data` ExternalClinicSchema[], required: A single page of data contained within this list. - `base_url` string, required: The base URL for the Vetcove client shopping portal. Respects custom/vanity shop domains when configured. This is the same `base_url` returned by auto-auth, without an auto-auth token. - `billing_address` ExternalAddressSchema, required - `address_one` string, required: The first line of the address. - `address_two` string: The second line of the address. - `city` string, required: The city of the address. - `country` 'CA' | 'US' | 'AS' | 'GU' | 'MP' | 'PR' | 'VI' - `county` string: The county of the address. - `id` integer, required: The ID of the address. - `name` string: The name of the address. - `phone_number` integer, nullable: The phone number of the address. - `state` string, required: The 2-letter code of the state/province/region of the address. Legacy data could deviate from the 2-letter code convention. - `zipcode` string, required: The zip code/postal code of the address. - `booking_url` string, required: The URL of this clinic's current client-facing appointment booking page. Respects custom/vanity shop domains when configured. - `client_display_name` string, required: The display name of this clinic shown to clients. - `clinic_timezone` string, required: The IANA timezone identifier where this clinic is located. - `created` string, date-time, required: The datetime this object was created. - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted. - `email` string, nullable: The email address of the clinic. - `group_location_code` string, nullable, required: The group location code of the clinic location group. Group location codes are a group's internal identifier for their clinics. - `id` integer, required: The unique identifier for the clinic. - `is_deleted` boolean, required: Whether this record is soft deleted or not. - `is_pims` boolean, required: Whether this clinic is PIMS-enabled or not. - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field. - `name` string, required: The name of this clinic. - `phone_number` integer, nullable, required: The phone number of the clinic. - `primary_address` ExternalAddressSchema, required - `address_one` string, required: The first line of the address. - `address_two` string: The second line of the address. - `city` string, required: The city of the address. - `country` 'CA' | 'US' | 'AS' | 'GU' | 'MP' | 'PR' | 'VI' - `county` string: The county of the address. - `id` integer, required: The ID of the address. - `name` string: The name of the address. - `phone_number` integer, nullable: The phone number of the address. - `state` string, required: The 2-letter code of the state/province/region of the address. Legacy data could deviate from the 2-letter code convention. - `zipcode` string, required: The zip code/postal code of the address. - `website_url` string, nullable, required: The website url of the clinic. - `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)