Upload and process lab PDF

post

https://api.voloridgehealth.com/extraction/lab/upload

Upload a lab result PDF for processing. Returns immediately with a jobId.

Two Upload Methods:

Base64 Upload (files ≤ 10MB): Include pdfFile with base64-encoded PDF.
Returns 202 Accepted with jobId and status "queued".
Presigned URL Upload (files > 10MB, up to 50MB): Omit pdfFile field.
Returns 200 OK with a presigned S3 URL. Then PUT your PDF directly to that URL.
Processing starts automatically when upload completes.

Processing Steps:

Language detection (English validation)
PHI detection and redaction
Lab result extraction with panel grouping
LOINC code mapping for standardization
UCUM unit code mapping for standardization

Processing Time: 2-5 minutes depending on page count

Webhook Notification: Provide a webhookUrl to receive push notifications
when processing completes. See WebhookPayload schema for payload structure.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

pdfFile

string

Base64-encoded PDF file (max 10MB after encoding).
Omit this field for files > 10MB to receive a presigned URL instead.

filename

string

Optional original filename for display purposes

dateOfBirth

date

Optional patient date of birth for verification (YYYY-MM-DD)

webhookUrl

uri

Optional webhook URL to receive notifications when processing completes.
Must be a publicly accessible HTTPS endpoint.

rejectIfPHI

boolean

Defaults to false

If true, immediately reject the document when any PHI is detected,
without performing redaction or extraction. The original PDF and all
intermediate files are deleted. Use this when PHI presence is
unacceptable rather than needing redaction.

When rejected, the job status will be "rejected_phi" and the webhook
event will be "job.rejected_phi".

Responses

200Presigned URL generated (when pdfFile is omitted)

202PDF accepted for processing (when pdfFile is provided)

400Invalid request parameters

413PDF file too large (max 10MB for base64 upload)

429Rate limit exceeded