> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/vantage-api/overview.md).

# Overview

Vantage API is Terra's diagnostics platform: order blood and DNA test kits, track fulfilment, and receive lab results in FHIR format through a single API.

The Terra **Vantage API** provides a comprehensive platform for managing blood test and DNA diagnostic products, processing orders, and delivering test results. This API enables healthcare providers, laboratories and partners to integrate diagnostic testing services directly into their applications.

Vantage API allows you to focus on providing the best healthcare experience for your end users while we handle the rest.

### Why we built Vantage API

The health tech space is currently at a turning point - with the commoditisation of highly accurate wearables, metrics like step counts, HRV and sleep scores are **readily available** to most end users. However, sensors alone **cannot provide truly actionable insights** without the most important factor - **biological context**.

This is where **biomarker testing** comes in.

The process of bringing biomarker testing to your users at a commercial scale is a complicated procedure, involving commercial agreements with third party labs, convoluted delivery and collection logistics and months of navigating compliance red tape required to provide a legally viable service.

Instead, we provide a single API:

* **Effortless integration** with numerous kit suppliers.
* Bulk discounts without bulk minimum orders - we **pass on volume discounts** directly to your customers.
* **No legal or compliance headaches** - start sending white-labelled panels within days instead of months.
* Normalisation of test results into a **global format (FHIR)** for easy handling.
* **Hands-off logistics networks** for fulfilment, shipping and result delivery.

In short: plug-and-play labs infrastructure.

### How an integration works

1. **Browse the catalog** - product types → products → variants ([Core concepts](/vantage-api/core-concepts.md)).
2. **Place an order** for a variant, either shipped to the end user's home (`AT_HOME`) or collected at a lab draw site (`GO_TO_LAB`).
3. **Track progress via webhooks** - fulfilment events (payment, shipping) and result events (kit activated, processing, ready).
4. **Download results** as a FHIR JSON document.
5. **Acknowledge the results** after your end user has viewed them - a mandatory compliance step ([Acknowledging Results](/vantage-api/acknowledging-results.md)).

Start with [Account setup and authentication](/vantage-api/account-setup-and-api-keys.md), then walk through [Ordering your first test](/vantage-api/ordering-your-first-test.md) in the sandbox.

### Base URLs

{% hint style="info" %}
**Production:**

```
https://vantage.tryterra.co
```

**Sandbox:**

```
https://vantage-sandbox.tryterra.co
```

{% endhint %}

### Supported Countries

* United Kingdom 🇬🇧
* USA 🇺🇸

Each environment can be limited to the products sold in one or both of these. See [Markets](/vantage-api/core-concepts.md#markets).

### Countries Coming Soon

* Germany 🇩🇪
* Spain 🇪🇸
* France 🇫🇷

### Use Vantage from your AI assistant

Your AI assistant can inspect and configure Vantage for you. Connect Claude, ChatGPT or another assistant through the [Terra MCP server](https://docs.tryterra.co/developer-tools/mcp-server), or give a coding agent the [Terra CLI](https://docs.tryterra.co/developer-tools/terra-cli/coding-agents) and the [Vantage agent skill](https://docs.tryterra.co/developer-tools/agent-skills). Then ask, for example:

* "Which Vantage webhooks failed in my sandbox this week, and why?"
* "Show me every delivery attempt for the webhooks of order 251285377984405504."
* "Limit my sandbox to products sold in the UK."
* "Which results in production are ready but not acknowledged yet?"
* "Send a test results webhook to my sandbox endpoint."
* "Which Vantage API version is my production environment on, and what changes if I upgrade?"
* "Build an order flow for our app with Vantage, starting with an at-home blood test." (coding agents)

If you are interested in getting involved as a client or supplier, please [reach out to the Terra API team](https://tryterra.co) to find out more.