> ## 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 doctors

> Returns a list of all doctors in the organization. The doctors are sorted by creation date, with the most recent doctors appearing first. When using modified filters, results are sorted in descending modification date instead.

A **doctor** is a veterinarian within an organization.



## OpenAPI

````yaml get /ext/v2/doctors/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/doctors/:
    get:
      tags:
        - Clinics
      summary: List all doctors
      description: >-
        Returns a list of all doctors in the organization. The doctors are
        sorted by creation date, with the most recent doctors appearing first.
        When using modified filters, results are sorted in descending
        modification date instead.


        A **doctor** is a veterinarian within an organization.
      operationId: doctors_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: Filters to doctors associated with the clinic with this ID.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Filters to doctors associated with the clinic with this ID.
            title: Clinic Id
        - description: >-
            When `True`, filters to active doctors. When `False`, filters to
            inactive doctors. When omitted, both are included.
          in: query
          name: is_active
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: >-
              When `True`, filters to active doctors. When `False`, filters to
              inactive doctors. When omitted, both are included.
            title: Is Active
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalDoctorSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalDoctorSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalDoctorSchema'
          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: ExternalDoctorSchemaList
      type: object
    ExternalDoctorSchema:
      properties:
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        credentials:
          description: The doctor's credentials (e.g. `DVM`, `VMD`).
          items:
            type: string
          title: Credentials
          type: array
        email:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The doctor's email address, if they have an associated clinic user
            account.
          title: Email
        first_name:
          description: The first name of the doctor.
          title: First Name
          type: string
        full_name:
          description: >-
            The doctor's full name. Matches the `authorizing_vet` field on order
            items.
          title: Full Name
          type: string
        id:
          description: The unique identifier for the doctor.
          title: Id
          type: integer
        is_active:
          description: >-
            Whether the doctor is active. Archived doctors and doctors whose
            clinic user is deactivated are inactive.
          title: Is Active
          type: boolean
        last_name:
          description: The last name of the doctor.
          title: Last Name
          type: string
        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
      required:
        - created
        - modified
        - id
        - first_name
        - last_name
        - full_name
        - is_active
        - credentials
      title: ExternalDoctorSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````