# Acknowledging Results

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

{% hint style="danger" %}
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.
{% endhint %}

{% hint style="warning" %}
If results remain unacknowledged, test suppliers and medical teams are authorised to **reach out directly** to patients to ensure they receive critical health information.
{% endhint %}

### Example Acknowledgement Page

* **N.B** Test taker cannot see results until acknowledging

<figure><img src="/files/Ldc3gHprxfBVFLvwJUDT" alt=""><figcaption></figcaption></figure>

### Acknowledgement Endpoint

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

{% tabs %}
{% tab title="cURL" %}

```javascript
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>'
  
```

{% endtab %}

{% tab title="Python" %}

```python
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)

```

{% endtab %}

{% tab title="Go" %}

```go
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))
}

```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tryterra.co/vantage-api-docs/important-information/acknowledging-results.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.