Acknowledging Results

This guide outlines the critical process of acknowledging patient results within the system. Result acknowledgment is a mandatory step that ensures proper communication of test outcomes, regardless of

Overview

Acknowledging results is not optional—it is a fundamental requirement in the patient care workflow. This acknowledgment serves as documentation that clients have reviewed test outcomes and take responsibility for communicating appropriate severity levels to their end users.

All results, whether indicating low to high clinical escalation, must be explicitly acknowledged within the system before patients can access their results. This mandatory acknowledgment protects patients by ensuring they receive informed guidance about their test outcomes and any necessary next steps.

Failure to acknowledge results initiates a chain of liability that transfers responsibility directly to you, and your organisation assumes full liability for any adverse outcomes resulting from delayed or unacknowledged results.

If results remain unacknowledged, test suppliers and medical teams are authorised to reach out directly to patients to ensure they receive critical health information.

Example Acknowledgement Page

N.B Test taker cannot see results until acknowledging

Acknowledgement Endpoint

POST /api/v1/results/{order_item_id}/acknowledge

curl --location --request POST \
  'https://vantage-sandbox.tryterra.co/api/v1/results/249956252111773699/acknowledge' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>'

import requests

order_item_id = 249956252111773699
url = f"https://vantage-sandbox.tryterra.co/api/v1/results/{order_item_id}/acknowledge"

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>'
}

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

print(response.json())
print(response.status_code)

package main

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

func main() {
	orderItemID := int64(249956252111773699)
	url := fmt.Sprintf("https://vantage-sandbox.tryterra.co/api/v1/results/%d/acknowledge", orderItemID)

	client := &http.Client{}
	req, err := http.NewRequest("POST", url, nil)
	if err != nil {
		panic(err)
	}

	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "Basic <YOUR_CLIENT_ID:YOUR_CLIENT_SECRET_BASE64>")

	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}

	fmt.Println(string(body))
}

PreviousResults

Last updated 15 days ago

Was this helpful?