> 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-docs/readme.md).

# What is Vantage 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-docs/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-docs/important-information/acknowledging-results.md)).

Start with [Account setup and authentication](/vantage-api-docs/account-setup-and-api-keys.md), then walk through [Ordering your first test](/vantage-api-docs/getting-started/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 🇺🇸

### Countries Coming Soon

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

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.