Overview

Convert lab report PDFs into structured, standardized biomarker data via a simple REST API.

⚠️ 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 — Upload, poll, and retrieve in 3 steps

2. Core Concepts — Session lifecycle, data model, async processing

3. API Reference — Full endpoint specifications

4. Webhook Payload — Payload format and field specs

5. Biomarker Reference — Standardization, UCUM codes, common biomarkers

6. Best Practices — Error handling, idempotency, rate limits