---
title: "List all imported conversations"
method: GET
path: "/ext/v2/imported-conversations/"
tags: ["Inbox"]
---

# List all imported conversations

`GET /ext/v2/imported-conversations/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/imported-conversations/`
- Auth: HTTP bearer

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.

## 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.
- `clinic_id` integer, nullable: When provided, filters to imported conversations for the clinic with this ID.
- `clinic_client_id` integer, nullable: When provided, filters to imported conversations for the clinic client with this ID.
- `clinic_patient_id` integer, nullable: When provided, filters to imported conversations attached to the clinic patient with this ID.

## Response `200`

OK

- ExternalImportedConversationSchemaList
  - `data` ExternalImportedConversationSchema[], required: A single page of data contained within this list.
    - `attachment_uploaded_file_ids` integer[], required: IDs of uploaded files attached to this conversation. Clients fetch the underlying file bytes via the `/file-uploads/` endpoints.
    - `clinic_client_id` integer, required: The ID of the clinic client (pet parent) the conversation is about.
    - `clinic_id` integer, required: The ID of the clinic the conversation belongs to.
    - `clinic_patient_ids` integer[], required: 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.
    - `created` string, date-time, required: The datetime this object was created.
    - `id` integer, required: The ID of the imported conversation record.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `text` string, required: The full conversation transcript, stored and rendered verbatim in the Vetcove patient timeline.
    - `title` string, nullable, required: Short label shown in the patient timeline preview row.
  - `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)