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
- ExplanationOfBenefit
- Condition
- MedicationRequest
- C-CDA documents (XML)
- 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
The patient connects
The patient shares records from their insurer, their providers or TEFCA through Flexpa Consent.
- 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
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
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.
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.zipResponse 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 legalCare navigation
Hand a clinician a readable history from every insurer, hospital and clinic the patient connected.
See care navigationHealth apps and devices
Let users download or print their own records from inside your product.
See health apps and devicesPlans
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.
Spotlights
More add-ons
MCP server
Give your agent the whole health record.
SSO (SAML, OIDC, SCIM sync)
Sign in to Flexpa like everything else.
Claims to clinical data normalization
Query claims like a medical record.
C-CDA to FHIR conversion
Turn TEFCA documents into FHIR you can query.
Proprietary network connections
Reach the employer plans your users actually have.
SMART Health Links
Share records with a link or a QR code.
Records people can actually read.
Connect a patient in the demo and see the record their PDF is built from.
Get a demo