# Solia Direct Documentation

> Solia Direct is an operating and connectivity layer for diagnostic laboratories. Connect the laboratory once and reuse that infrastructure across multiple Programs and partners through one Control Plane and Partner API—without replacing the LIS/LIMS.

Canonical documentation host: https://docs.soliadirect.com

## Machine-readable resources

- [OpenAPI Specification](https://docs.soliadirect.com/api-reference/openapi): OpenAPI 3.1 JSON at https://docs.soliadirect.com/api/public/partner-openapi
- [Postman collection](https://docs.soliadirect.com/developer/solia-direct-partner-api.postman_collection.json): generated from the OpenAPI document
- [Postman environment template](https://docs.soliadirect.com/developer/solia-direct-sandbox.postman_environment.json): placeholders only
- [Full public documentation text](https://docs.soliadirect.com/llms-full.txt)

## Get Started

- [Introduction](https://docs.soliadirect.com/introduction): What Solia Direct is, who it is for, and how the documentation is organized.
- [Quickstart](https://docs.soliadirect.com/quickstart): Laboratory setup, then a complete Sandbox developer workflow from authentication to a released result and reconciled events.
- [Environments](https://docs.soliadirect.com/environments): How Sandbox evaluation and Production operation differ, and how testing works after go-live.
- [Sandbox](https://docs.soliadirect.com/sandbox): Purpose, isolation, credentials and safe testing boundaries of the Sandbox environment.
- [Platform overview](https://docs.soliadirect.com/platform-overview): The operating model: laboratory workspace, programs, catalog, orders, results and partner access.

## Platform

- [Architecture](https://docs.soliadirect.com/architecture): How requests, tenancy, and the partner surface fit together.
- [Operating the Control Plane](https://docs.soliadirect.com/operations/control-plane): How the main operational surfaces work together after setup and activation.
- [Catalog](https://docs.soliadirect.com/control-plane/catalog): Orderable tests, panels, pricing and laboratory code mappings.
- [Fulfillment](https://docs.soliadirect.com/control-plane/fulfillment): Collection models, service area and collection locations.
- [Programs and the Overview operating model](https://docs.soliadirect.com/control-plane/programs): How the Overview surface reflects operational health, readiness and programs.
- [Orders](https://docs.soliadirect.com/control-plane/orders): The canonical order record and its lifecycle.
- [Customers](https://docs.soliadirect.com/control-plane/customers): Subject records created through ordering.
- [Results](https://docs.soliadirect.com/control-plane/results): Released results, versions and provenance.
- [Integrations](https://docs.soliadirect.com/control-plane/integrations): The integration hub inside the Control Plane.
- [Production readiness](https://docs.soliadirect.com/operations/production-readiness): What must be true before a laboratory goes live, and how activation finalizes.
- [Monitoring](https://docs.soliadirect.com/operations/monitoring): Where to watch an integration in production.
- [Exceptions](https://docs.soliadirect.com/operations/exceptions): How operational problems are represented.

## Partner API

- [Partner API overview](https://docs.soliadirect.com/partner-api/overview): One versioned API for programs and catalog, serviceability, orders, results and events.
- [Authentication](https://docs.soliadirect.com/partner-api/authentication): Bearer API keys bound to one environment and one scope set.
- [API clients](https://docs.soliadirect.com/partner-api/api-clients): How partner clients are registered and how keys are issued.
- [Program access](https://docs.soliadirect.com/partner-api/program-access): Why access is granted per program, and what a grant permits.
- [Clinical requirements & serviceability](https://docs.soliadirect.com/partner-api/clinical-requirements): Discover governed order questions and separate clinical, provider and fulfillment decisions.
- [Orders (Partner API)](https://docs.soliadirect.com/partner-api/orders): Create, retrieve and cancel orders.
- [Results (Partner API)](https://docs.soliadirect.com/partner-api/results): Released result sets, versions and reports.
- [Webhooks](https://docs.soliadirect.com/partner-api/webhooks): Registration, signature verification, delivery and retry semantics.
- [Testing in Sandbox](https://docs.soliadirect.com/partner-api/sandbox-testing): Deterministic fixtures and scenarios for integration testing.

## Laboratory Integration

- [Laboratory connection](https://docs.soliadirect.com/laboratory/connection): Technical hub for connecting a LIS or LIMS: architecture, transports, contracts, operations and troubleshooting.
- [Order interface](https://docs.soliadirect.com/laboratory/order-interface): How orders are delivered to the laboratory.
- [Result interface](https://docs.soliadirect.com/laboratory/result-interface): How acknowledgements, statuses and results come back.
- [Collection](https://docs.soliadirect.com/laboratory/collection): Collection models and serviceable locations.
- [Mappings](https://docs.soliadirect.com/laboratory/mappings): Linking Solia orderables to laboratory codes.
- [Validation](https://docs.soliadirect.com/laboratory/validation): Proving an integration works before Production.

## Integration Guides

- [Partner API integration guide](https://docs.soliadirect.com/guides/partner-api-integration): Architecture, authentication, scopes, ordering, results, events and retries for a partner integration.
- [Managed laboratory interfaces](https://docs.soliadirect.com/guides/managed-laboratory-interfaces): HL7 v2, FHIR and SFTP/file integrations prepared with Solia, and how they differ from self-service HTTPS/JSON.
- [Webhooks & event reconciliation](https://docs.soliadirect.com/guides/webhook-reconciliation): Receiving, verifying, deduplicating and reconciling signed event deliveries.
- [Catalog & mappings](https://docs.soliadirect.com/guides/catalog-mappings): Canonical Catalog, laboratory codes, biomarker mapping, lifecycle and what each channel sees.
- [Result ingestion & release](https://docs.soliadirect.com/guides/result-release): How results return from the laboratory, how release works and what is authoritative.
- [Sandbox to Production](https://docs.soliadirect.com/guides/sandbox-to-production): What carries forward, what stays environment-specific, and how Production is validated.
- [Standard DTC preview & publish](https://docs.soliadirect.com/guides/standard-dtc-preview-publish): Experience configuration ownership, exact-draft private preview, publish gating and current limitations.
- [Existing Laboratory Portal](https://docs.soliadirect.com/guides/existing-laboratory-portal): Routing patients to the laboratory's own results portal instead of the Solia Patient Portal.
- [Examples](https://docs.soliadirect.com/examples): Copyable cURL and TypeScript examples for the current Partner API, webhooks and laboratory contract.

## Standard DTC

- [Standard DTC Runtime](https://docs.soliadirect.com/standard-dtc/runtime): How the optional consumer storefront is served from canonical platform truth.
- [Patient Portal](https://docs.soliadirect.com/standard-dtc/patient-portal): The consumer results portal and its current availability.
- [Experience](https://docs.soliadirect.com/control-plane/experience): The consumer-facing surface configuration.

## Security & Production

- [Security architecture](https://docs.soliadirect.com/security/architecture): Enforced boundaries for people, API clients, environments, Programs and outbound delivery.
- [Tenant isolation](https://docs.soliadirect.com/security/tenant-isolation): How workspace boundaries are enforced.
- [Authentication and sessions](https://docs.soliadirect.com/security/authentication): How people and machines authenticate, and how sessions are handled.
- [Roles and access](https://docs.soliadirect.com/security/roles-access): Role-based access inside a workspace.
- [Encryption and secrets](https://docs.soliadirect.com/security/secrets): How credentials and secrets are handled.
- [Auditability](https://docs.soliadirect.com/security/auditability): What the platform records, and how that record can be reviewed.
- [Environment separation](https://docs.soliadirect.com/security/environment-separation): Why Sandbox can never reach Production.
- [Shared responsibility](https://docs.soliadirect.com/security/shared-responsibility): What Solia does and what you do.
- [Troubleshooting](https://docs.soliadirect.com/operations/troubleshooting): Common failures and the first thing to check.

## Reference

- [API reference](https://docs.soliadirect.com/api-reference): The versioned Partner API surface, its envelopes and its machine-readable description.
- [OpenAPI Specification](https://docs.soliadirect.com/api-reference/openapi): The canonical, machine-readable OpenAPI 3.1 description of the Partner API, plus generated Postman artifacts.
- [Health endpoints](https://docs.soliadirect.com/api-reference/health): Exact request and response contracts for the health endpoints, generated from the enforced Partner API contract.
- [Laboratory endpoints](https://docs.soliadirect.com/api-reference/laboratory): Exact request and response contracts for the laboratory endpoints, generated from the enforced Partner API contract.
- [Locations endpoints](https://docs.soliadirect.com/api-reference/locations): Exact request and response contracts for the locations endpoints, generated from the enforced Partner API contract.
- [Programs endpoints](https://docs.soliadirect.com/api-reference/programs): Exact request and response contracts for the programs endpoints, generated from the enforced Partner API contract.
- [Serviceability endpoints](https://docs.soliadirect.com/api-reference/serviceability): Exact request and response contracts for the serviceability endpoints, generated from the enforced Partner API contract.
- [Subjects endpoints](https://docs.soliadirect.com/api-reference/subjects): Exact request and response contracts for the subjects endpoints, generated from the enforced Partner API contract.
- [Orders endpoints](https://docs.soliadirect.com/api-reference/orders): Exact request and response contracts for the orders endpoints, generated from the enforced Partner API contract.
- [Results endpoints](https://docs.soliadirect.com/api-reference/results): Exact request and response contracts for the results endpoints, generated from the enforced Partner API contract.
- [Events endpoints](https://docs.soliadirect.com/api-reference/events): Exact request and response contracts for the events endpoints, generated from the enforced Partner API contract.
- [Sandbox endpoints](https://docs.soliadirect.com/api-reference/sandbox): Exact request and response contracts for the sandbox endpoints, generated from the enforced Partner API contract.
- [Errors](https://docs.soliadirect.com/api-reference/errors): Error envelope, status codes and retryability.
- [Idempotency](https://docs.soliadirect.com/api-reference/idempotency): Safe retries on writes and at-least-once events.
- [Events](https://docs.soliadirect.com/partner-api/events): The event catalog, envelope and reconciliation stream.
- [Public changelog](https://docs.soliadirect.com/changelog): Solia's public changelog begins with the next documented platform or API release.
- [Glossary](https://docs.soliadirect.com/resources/glossary): Terms used across the platform and these docs.
- [Status definitions](https://docs.soliadirect.com/resources/status-definitions): What the platform's states mean.
- [Technical FAQ](https://docs.soliadirect.com/resources/faq): Direct answers to recurring technical questions.

## Support

- [Getting support](https://docs.soliadirect.com/support/getting-support): How to reach Solia and what to include so an engineering issue can be diagnosed quickly.

## External resources

- [System Status](https://status.soliadirect.com): Platform availability and incident history