> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all clinics > 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. ## OpenAPI ````yaml get /ext/v2/clinics/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/clinics/: get: tags: - Clinics summary: List all clinics description: >- 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. operationId: clinics_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- 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. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- 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. title: Cursor - description: >- 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. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Gte - description: >- 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. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Lte - description: >- 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. in: query name: is_deleted required: false schema: allOf: - enum: - 'FALSE' - 'TRUE' - ALL title: DeletedFilterOption type: string default: 'FALSE' description: >- 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. - description: >- When provided, filters to clinics for the list of group location codes. Group location codes are a group's internal identifier for their clinics. in: query name: group_location_codes required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- When provided, filters to clinics for the list of group location codes. Group location codes are a group's internal identifier for their clinics. title: Group Location Codes - description: >- When `True`, filters to PIMS-enabled clinics. When `False`, filters to non-PIMS clinics. When `None`, then both are included. in: query name: is_pims required: false schema: anyOf: - type: boolean - type: 'null' description: >- When `True`, filters to PIMS-enabled clinics. When `False`, filters to non-PIMS clinics. When `None`, then both are included. title: Is Pims responses: '200': content: application/json: schema: $ref: '#/components/schemas/ClinicList' description: OK security: - ExternalAPIAuth: [] components: schemas: ClinicList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalClinicSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ClinicList type: object ExternalClinicSchema: description: >- Clinics represent a physical site where clients (pet owners) can go seek care for patients (their pets). properties: base_url: description: >- 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. title: Base Url type: string billing_address: anyOf: - $ref: '#/components/schemas/ExternalAddressSchema' - type: 'null' description: The billing address of the clinic. booking_url: description: >- The URL of this clinic's current client-facing appointment booking page. Respects custom/vanity shop domains when configured. title: Booking Url type: string client_display_name: description: The display name of this clinic shown to clients. title: Client Display Name type: string clinic_timezone: description: The IANA timezone identifier where this clinic is located. title: Clinic Timezone type: string created: description: The datetime this object was created. format: date-time title: Created type: string deleted: anyOf: - format: date-time type: string - type: 'null' description: The datetime this record was soft deleted. title: Deleted email: anyOf: - type: string - type: 'null' description: The email address of the clinic. title: Email group_location_code: anyOf: - type: string - type: 'null' description: >- The group location code of the clinic location group. Group location codes are a group's internal identifier for their clinics. title: Group Location Code id: description: The unique identifier for the clinic. title: Id type: integer is_deleted: description: Whether this record is soft deleted or not. title: Is Deleted type: boolean is_pims: description: Whether this clinic is PIMS-enabled or not. title: Is Pims type: boolean modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string name: description: The name of this clinic. title: Name type: string phone_number: anyOf: - type: integer - type: 'null' description: The phone number of the clinic. title: Phone Number primary_address: anyOf: - $ref: '#/components/schemas/ExternalAddressSchema' - type: 'null' description: The primary address of the clinic. website_url: anyOf: - type: string - type: 'null' description: The website url of the clinic. title: Website Url required: - created - modified - is_deleted - deleted - id - name - client_display_name - primary_address - billing_address - phone_number - website_url - base_url - booking_url - group_location_code - is_pims - clinic_timezone title: Clinic type: object ExternalAddressSchema: properties: address_one: description: The first line of the address. maxLength: 100 title: Address One type: string address_two: default: '' description: The second line of the address. maxLength: 100 title: Address Two type: string city: description: The city of the address. maxLength: 100 title: City type: string country: allOf: - $ref: '#/components/schemas/Countries' default: US description: The 2-letter code of the country of the address. county: default: '' description: The county of the address. maxLength: 100 title: County type: string id: description: The ID of the address. title: Id type: integer name: default: '' description: The name of the address. maxLength: 100 title: Name type: string phone_number: anyOf: - type: integer - type: 'null' description: The phone number of the address. title: Phone Number state: description: >- The 2-letter code of the state/province/region of the address. Legacy data could deviate from the 2-letter code convention. title: State type: string zipcode: description: The zip code/postal code of the address. maxLength: 10 title: Zipcode type: string required: - address_one - city - state - zipcode - id title: ExternalAddressSchema type: object Countries: enum: - CA - US - AS - GU - MP - PR - VI title: Countries type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````