> ## 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 imported conversations

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

An **imported conversation** is a read-only transcript of a completed conversation (typically SMS) written back into Vetcove from a partner communications platform.

Imported conversations do not appear in the Vetcove inbox. They surface on the patient timeline so clinic staff can read prior client outreach alongside the rest of the patient record. When a conversation is submitted without a patient, it is attached to every active patient of the clinic client so that it appears on each of their timelines.



## OpenAPI

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


        An **imported conversation** is a read-only transcript of a completed
        conversation (typically SMS) written back into Vetcove from a partner
        communications platform.


        Imported conversations do not appear in the Vetcove inbox. They surface
        on the patient timeline so clinic staff can read prior client outreach
        alongside the rest of the patient record. When a conversation is
        submitted without a patient, it is attached to every active patient of
        the clinic client so that it appears on each of their timelines.
      operationId: imported_conversations_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 provided, filters to imported conversations for the clinic with
            this ID.
          in: query
          name: clinic_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              When provided, filters to imported conversations for the clinic
              with this ID.
            title: Clinic Id
        - description: >-
            When provided, filters to imported conversations for the clinic
            client with this ID.
          in: query
          name: clinic_client_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              When provided, filters to imported conversations for the clinic
              client with this ID.
            title: Clinic Client Id
        - description: >-
            When provided, filters to imported conversations attached to the
            clinic patient with this ID.
          in: query
          name: clinic_patient_id
          required: false
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: >-
              When provided, filters to imported conversations attached to the
              clinic patient with this ID.
            title: Clinic Patient Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalImportedConversationSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalImportedConversationSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalImportedConversationSchema'
          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: ExternalImportedConversationSchemaList
      type: object
    ExternalImportedConversationSchema:
      properties:
        attachment_uploaded_file_ids:
          description: >-
            IDs of uploaded files attached to this conversation. Clients fetch
            the underlying file bytes via the `/file-uploads/` endpoints.
          items:
            type: integer
          title: Attachment Uploaded File Ids
          type: array
        clinic_client_id:
          description: The ID of the clinic client (pet parent) the conversation is about.
          title: Clinic Client Id
          type: integer
        clinic_id:
          description: The ID of the clinic the conversation belongs to.
          title: Clinic Id
          type: integer
        clinic_patient_ids:
          description: >-
            The IDs of the clinic patients the conversation is attached to.
            Conversations submitted without a patient are fanned out to every
            active patient of the client at ingest time.
          items:
            type: integer
          title: Clinic Patient Ids
          type: array
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        id:
          description: The ID of the imported conversation record.
          title: Id
          type: integer
        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
        text:
          description: >-
            The full conversation transcript, stored and rendered verbatim in
            the Vetcove patient timeline.
          title: Text
          type: string
        title:
          anyOf:
            - type: string
            - type: 'null'
          description: Short label shown in the patient timeline preview row.
          title: Title
      required:
        - created
        - modified
        - id
        - clinic_id
        - clinic_client_id
        - clinic_patient_ids
        - title
        - text
        - attachment_uploaded_file_ids
      title: ExternalImportedConversationSchema
      type: object
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````