SpotlightC-CDA to PDF conversion

Every record, one PDF.

The Patient $pdf operation turns a patient's claims, clinical data and C-CDA documents into one readable PDF, or a ZIP with one PDF per source, in a single API call.

Included from Growth · $5,000/year on lower plans · Read the docs

Returned by the API
  • ExplanationOfBenefit
  • Condition
  • MedicationRequest
  • C-CDA documents (XML)
Ready to read
  • health-export.pdf
  • or a ZIP, one PDF per source

01The short answer

What is C-CDA to PDF conversion?

C-CDA to PDF conversion is a Flexpa add-on that renders a patient's records as a document a person can read. It maps every resource from Patient $everything into 26 sections, from demographics and problems to claims, labs and immunizations, and renders attached clinical documents, including C-CDA XML from TEFCA and medical record systems.

Nothing is silently dropped. A resource type without its own section renders under Other Records, and a document that cannot be parsed gets a placeholder instead of disappearing.

Used by Solverein.

02How it works

From connection to result

  1. 1

    The patient connects

    The patient shares records from their insurer, their providers or TEFCA through Flexpa Consent.

  2. 2

    Call Patient $pdf

    With a patient access token and the wildcard $PATIENT_ID, you get one stitched PDF with a section per connected source. TEFCA documents are stitched into one PDF per facility.

  3. 3

    Shape the export

    Add _format=zip for one file per source, _type to keep only certain resource types, or patient-authorization-id to export a single connection.

  4. 4

    Check it is complete

    Response headers report the number of sources, any that failed to render and the number of resources included, so you can verify the export without parsing the PDF.

Request
curl 'https://api.flexpa.com/fhir/Patient/$PATIENT_ID/$pdf' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --output health-export.pdf

# One PDF per source, in a ZIP
curl 'https://api.flexpa.com/fhir/Patient/$PATIENT_ID/$pdf?_format=zip' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --output health-export.zip

Response headers

Returned with every export.

  • X-PDF-Sources-Total
  • X-PDF-Sources-Failed
  • X-PDF-Sources-Failed-Names
  • X-PDF-Resource-Count

Good to know

  • The wildcard $PATIENT_ID needs a patient access token. A specific patient ID uses an application access token.
  • C-CDA 1.1, 2.0 and 2.1 documents are rendered section by section. PDF documents pass through as they are, and HTML, RTF and plain text are rendered.
  • An X-PDF-Sources-Failed value above zero means the PDF may be incomplete.
  • TEFCA connections contribute only documents, so a _type filter without DocumentReference leaves them out.

03Who it's for

Where it pays off

Legal

Attorneys and reviewers read documents. Drop a claimant’s full record into a demand package or medical chronology.

See legal

Care navigation

Hand a clinician a readable history from every insurer, hospital and clinic the patient connected.

See care navigation

Health apps and devices

Let users download or print their own records from inside your product.

See health apps and devices

Plans

Included in Growth and above

C-CDA to PDF conversion is included in the Growth, Scale, Omni and Infrastructure plans. On Startup, it is $5,000 a year.

04A few good questions

C-CDA to PDF conversion,
answered.

Can I get one PDF per source?

Yes. With _format=zip you get a ZIP with one file per payer or provider connection, and one file per facility for TEFCA.

Does it include TEFCA documents?

Yes. C-CDA documents retrieved through TEFCA are rendered and stitched into one PDF per facility, inside the full export or as separate files in the ZIP.

Can I limit the export to certain records?

Yes. Pass _type with the resource types you want, such as Condition and MedicationRequest. Demographics always render.

What happens to a malformed document?

A placeholder noting the parse failure is rendered in its place, so the reader knows a document existed.

Which Flexpa plans include C-CDA to PDF conversion?

C-CDA to PDF conversion is included in the Growth, Scale, Omni and Infrastructure plans. On Startup, it is $5,000 a year.

Records people can actually read.

Connect a patient in the demo and see the record their PDF is built from.

Get a demo