Imported Conversations

Fetch an imported conversation

Retrieves an imported conversation by its ID.

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.

GET

ext

imported-conversations

{imported_conversation_id}

Fetch an imported conversation

curl --request GET \
  --url https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "attachment_uploaded_file_ids": [
    123
  ],
  "clinic_client_id": 123,
  "clinic_id": 123,
  "clinic_patient_ids": [
    123
  ],
  "created": "2023-11-07T05:31:56Z",
  "id": 123,
  "modified": "2023-11-07T05:31:56Z",
  "text": "<string>",
  "title": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

imported_conversation_id

integer

required

Response

200 - application/json

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.

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 | null

required

Short label shown in the patient timeline preview row.

⌘I

Fetch an imported conversation

curl --request GET \
  --url https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://connect.vetcove.com/ext/v2/imported-conversations/{imported_conversation_id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "attachment_uploaded_file_ids": [
    123
  ],
  "clinic_client_id": 123,
  "clinic_id": 123,
  "clinic_patient_ids": [
    123
  ],
  "created": "2023-11-07T05:31:56Z",
  "id": 123,
  "modified": "2023-11-07T05:31:56Z",
  "text": "<string>",
  "title": "<string>"
}

Using the API

Developer guides

Accounts

Care plans

Catalog

Checkout links

Clients & patients

Clinics

External Rx

Insurance

Inbox

Invoices

Labs

Onboardings

Orders

Payments

PDFs

Prescriptions

Scheduler

Service pricing

Standard care

Subscriptions

File uploads

Inventory

Forms

Medical records

Fetch an imported conversation

Authorizations

Path Parameters

Response