Skip to main content

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 — the task_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.
Because the flow is asynchronous, POST /task/create never returns verdicts. Read results from GET /task/get after the Task reaches a terminal status. See Working with async results.

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.