> 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/lab-reports/lab-reports.md).

# Overview

> ⚠️ **Pre-Release**
>
> This page is currently under active development and is provided in a pre-release state.
>
> Some content may evolve as we continue to iterate on the implementation based on your feedback, but the core concepts and functionality are expected to remain consistent.
>
> The page will be marked as general release in the near future

## Terra Lab Reports API

Upload a lab report and receive structured biomarker data — extracted, standardized, and delivered to your webhook or available via REST.

### Key Features

* **Multi-Format Upload** — Upload clinical lab reports as PDF, PNG, JPEG, GIF, or WebP (up to 20 MB)
* **Biomarker Standardization** — Results are fuzzy-matched against a 4,200+ biomarker reference dataset, producing a canonical `biomarker` slug and UCUM-compliant unit codes
* **Reference Ranges with Context** — Extracted ranges include demographic context (sex, age, pregnancy status, menstrual cycle phase)
* **Async Processing** — Upload returns immediately with a session ID; results arrive via webhook or polling
* **Webhook Delivery** — Full session payload is delivered automatically to your configured destination on completion
* **Flexible Querying** — List and filter sessions by reference ID, date range, limit, and offset

### API Endpoints

| Method | Endpoint                                 | Description              |
| ------ | ---------------------------------------- | ------------------------ |
| POST   | `/v2/lab-reports`                        | Upload a lab report      |
| GET    | `/v2/lab-reports`                        | List sessions            |
| GET    | `/v2/lab-reports/{session_id}`           | Retrieve session details |
| POST   | `/v2/lab-reports/{session_id}/reprocess` | Reprocess a session      |
| DELETE | `/v2/lab-reports/{session_id}`           | Delete a session         |

Base URL: `https://access.tryterra.co/api`

### Documentation

1. [Quick Start](/lab-reports/quickstart.md) — Upload, poll, and retrieve in 3 steps
2. [Core Concepts](/lab-reports/core-concepts.md) — Session lifecycle, data model, async processing
3. [API Reference](/lab-reports/api-reference.md) — Full endpoint specifications
4. [Webhook Payload](/lab-reports/webhook-payload.md) — Payload format and field specs
5. [Biomarker Reference](/lab-reports/biomarker-reference.md) — Standardization, UCUM codes, common biomarkers
6. [Best Practices](/lab-reports/best-practices.md) — Error handling, idempotency, rate limits