> 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.md).

# Vantage API

- [Overview](https://docs.tryterra.co/vantage-api/overview.md): 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.
- [Account setup and authentication](https://docs.tryterra.co/vantage-api/account-setup-and-api-keys.md): How to get Vantage API access, authenticate your requests, and configure the webhook endpoint that receives order and result updates.
- [Core concepts](https://docs.tryterra.co/vantage-api/core-concepts.md): The Vantage API data model: catalog structure, orders and order items, recipients and test takers, status lifecycles, and conventions used across all endpoints.
- [Ordering your first test](https://docs.tryterra.co/vantage-api/ordering-your-first-test.md): Place your first sandbox order in a few minutes: browse the catalog, order a test kit, and watch the fulfilment webhooks arrive.
- [Working with Sandbox](https://docs.tryterra.co/vantage-api/working-with-sandbox.md): Simulate the full kit journey in sandbox - either by driving lifecycle events directly with the simulate endpoint, or by walking the realistic supplier flow with kit activation - then fetch and acknow
- [Webhooks](https://docs.tryterra.co/vantage-api/webhooks.md): How Vantage API delivers order and result updates to your endpoint: event families and payloads, HMAC signature verification, and retry semantics.
- [Managing orders](https://docs.tryterra.co/vantage-api/managing-orders.md): Track orders after placement: fetch full order detail with status history, list and filter orders and results, and curate which products your catalog returns.
- [Test Collection Methods](https://docs.tryterra.co/vantage-api/test-collection-methods.md): AT\_HOME vs GO\_TO\_LAB orders: which address fields each requires, how lab routing works, and how to find nearby lab draw sites.
- [Results](https://docs.tryterra.co/vantage-api/results.md): Fetching test results as FHIR documents: the download flow, how to read the Bundle structure, out-of-range and critical values, and failure scenarios.
- [Errors](https://docs.tryterra.co/vantage-api/errors.md): The error format Vantage API uses (RFC 7807 problem details), what each HTTP status code means, and how to handle validation failures.
- [Monitoring and debugging](https://docs.tryterra.co/vantage-api/monitoring.md): Observe your integration in production: the analytics overview endpoint, webhook delivery outcomes, and how to debug missed webhooks.
- [Best practices](https://docs.tryterra.co/vantage-api/best-practices.md): Patterns that keep a Vantage integration robust: webhook handling, deduplication, safe retries, ID handling, and result delivery done right.
- [Acknowledging Results](https://docs.tryterra.co/vantage-api/acknowledging-results.md): Result acknowledgment is a mandatory compliance step: patients cannot access their results until you acknowledge them, and failing to acknowledge transfers liability to your organisation.
- [Going to production](https://docs.tryterra.co/vantage-api/going-to-production.md): A checklist for moving your Vantage integration from sandbox to production safely.