---
title: "Create Lab Report Share"
method: POST
path: "/api/v3/lab-report-shares/"
tags: ["Lab report shares"]
---

# Create Lab Report Share

`POST /api/v3/lab-report-shares/`

## Request

- Base URL: `https://api.endless.health` (the document declares no server; this is the origin it was published from)
- URL: `https://api.endless.health/api/v3/lab-report-shares/`
- Auth: none declared

Create a share, email the recipient, and return the share status.

Inputs:
    body: Recipient, signature, locale, and requisition ids.
    request: Used for Origin/CSRF and truncated IP metadata.
    Remaining arguments are FastAPI dependencies.
Output:
    LabReportShareResponseSchema. Token is emailed, never returned.

## Request body

- LabReportShareCreateSchema
  - `requisition_id` integer, nullable
  - `requisition_ids` integer[]
  - `report_id` integer, nullable
  - `recipient_name` string, required
  - `recipient_email` string, email, required
  - `legal_basis` 'HIPAA_AUTHORIZATION_164_508'
  - `authorization_text_version` string
  - `typed_signature` string, required
  - `locale` string

## Response `200`

Successful Response

- LabReportShareResponseSchema
  - `public_id` string, uuid, required
  - `external_requisition_id` integer, required
  - `report_id` integer, required
  - `report_ids` integer[]
  - `report_sha256` string, required
  - `report_generation` integer, required
  - `state` string, required
  - `expires_at` string, date-time, required
  - `email_accepted_at` string, date-time, nullable
  - `email_delivered_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable
  - `locked_at` string, date-time, nullable
  - `downloaded_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `recipient_email_domain` string, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/endless/apis/eh-core-v3-api-prod.md) - [All operations](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/llms.txt) - [OpenAPI document](https://skmtc.dev/endless/apis/eh-core-v3-api-prod/revisions/9046a1eb2d0c?raw)