One API for the patient journey
Synthpop turns the slow, manual, document-heavy work of healthcare operations into a single programmable surface. You submit the documents you already receive — referrals, orders, clinical notes, insurance cards, forms — and Synthpop reads them, structures them, validates them against clinical and payer requirements, and drives the follow-up. Intake, coverage, and patient engagement all run through one resource: the Task.- One integration, three capabilities. Referral & order intake, coverage & authorization, and patient engagement share the same endpoints and the same response shape.
- Documents in, decisions out. Upload PDFs, images, text, or audio; read back structured records, per-code verdicts, and a plain-English conclusion.
- Asynchronous by design. Create a Task and get an ID immediately; results arrive as the Task moves to a terminal status.
Get your first result
Go from an API key to a validated Task in five steps.
API reference
Eight endpoints, one resource. Explore the full contract.
Your first request
Every capability starts the same way:POST /task/create with a task_type and
one or more documents. It returns immediately with a Task ID and
status: "pending" — Synthpop processes the work in the background.
task_type is required and is provisioned for your organization during
onboarding — there is no discovery endpoint. task shown above is an
org-provisioned convenience type that auto-classifies the document and routes it
to the right workflow; your Synthpop contact will tell you which task types are
enabled for you. See the Quickstart for the full auth-to-result
path.Three capabilities, one Task
The public API exposes a single lever — thetask_type you choose on create.
The same integration covers the whole journey.
Referral & order intake
Classify and validate incoming referrals and orders. Extract structured
records, check documentation against clinical and payer rules, and get a
per-code verdict on whether the request is supported.
Coverage & authorization
Evaluate coverage and authorization requirements alongside the clinical
documentation, so you know what a payer needs before you submit.
Patient engagement
Reach patients to gather missing information and move cases forward,
including the voice agent for enabled organizations.
What you can build
Automated intake triage
Drop every faxed or emailed packet into Synthpop and let it sort complete
submissions from those that need follow-up — no manual page-sorting.
Documentation & compliance checks
Validate that a referral or order carries the records and evidence a payer
requires, with issues surfaced field-by-field.
Structured data extraction
Pull demographics, diagnosis codes, service dates, and insurance details out
of scanned, handwritten, or out-of-order documents.
Closed-loop patient outreach
Trigger patient engagement to collect what’s missing and route the completed
case back into your workflow.
How it works
One Task threads a patient’s case through the whole journey. You create it, feed it documents, and read back a structured result — Synthpop does the reading, structuring, validating, and engaging in between.1
Create a Task
POST /task/create with a task_type and your documents. You get a Task ID
and status: "pending" right away.2
Synthpop processes it
The Task moves through
processing. It classifies and reads each document,
extracts structured medical records, and evaluates them.3
Read the result
Poll
GET /task/get (or receive an opt-in callback) until the Task reaches a
terminal status. If it needs more from you it pauses at waiting; you upload
the missing documents and it resumes.4
Act on the verdict
A completed validation Task carries per-code
verdicts, plain-English
verdict_summaries, and any issues — everything you need to move forward or
follow up.Resources
Quickstart
Zero to your first validated result.
API reference
The full endpoint and schema reference.
Changelog
What’s new in the public API.
Support
Reach the Synthpop team.

