API

Build on MedForward

Connect MedForward to your existing systems with our vendor API. Retrieve submissions, download PDFs, manage form groups, and integrate patient data into your EHR, practice management software, or custom workflows.

What You Can Do With the API

MedForward's vendor API gives your development team secure, authenticated access to submitted form data — including structured field values, PDFs, attachments, and form group management.

Retrieve Submissions

List and retrieve submitted form data by form name, with filtering by archive status and submission date. Get structured field-value pairs or flat key-value responses.

Download PDFs & Attachments

Download completed form PDFs and any attached files directly through the API. Supports individual file downloads and bulk zip exports.

Submit Forms

Submit form data programmatically using CSV field labels and values. Attach files to submissions within a 2-hour window after submission.

Manage Form Groups

List, retrieve, and manage form groups — collections of related forms submitted together. Archive and unarchive groups as part of your workflow.

Available Queries

All queries use a single endpoint with vendor authentication via query parameters. Pass your vendor name and key with each request.

Forms

list List submitted form IDs by form name, with optional archive and date filters.
listmore List submitted form details including submitter name, DOB, office, and submit date.
get Retrieve labeled field-value pairs for a submitted form by its ID.
get2 Retrieve flat key-value data for a submitted form by its ID.
getpdf Download the PDF for a submitted form as a binary stream.
submitform Submit form data using a JSON array of fieldid-value pairs matched to CSV labels.

Attachments

attachfile Attach a file to a submitted form within 2 hours of submission.
getattachments List attached files for a submitted form, including filename, type, and size.
downloadattachment Download a single attached file by submitted form ID and file ID.
downloadattachments Download all attachments for a submitted form as a zip file.

Form Groups

grouplist List submitted form group IDs by group name, with optional filters.
grouplistmore List submitted form group details including submitter name, DOB, and submit date.
groupinfo List the individual forms within a submitted form group.
groupget Retrieve field-value pairs for all forms in a group, with optional form ID filtering.
groupget2 Retrieve flat key-value data for all forms in a group, with optional form ID filtering.
groupgetpdf Download combined or individual PDFs for a form group.
groupgetattachments List attached files for all forms in a submitted form group.
groupdownloadattachment Download a single attached file from a form group by group ID and file ID.
groupdownloadattachments Download all attachments for a form group as a zip file.

Archive Management

archive Archive a submitted form by its ID.
unarchive Unarchive a previously archived submitted form.
grouparchive Archive an entire submitted form group.
groupunarchive Unarchive a previously archived form group.

Full API documentation — including response formats, error codes, and integration guides — is provided during onboarding. Contact us to learn more about API access.

Secure by Design

Every API request is authenticated and encrypted. The same HIPAA compliance that protects your patient data in MedForward extends to every API call.

Vendor Authentication

Each integration receives a unique vendor name and API key. Credentials are validated on every request, and the API is invisible to unauthenticated callers.

TLS Encryption

All API traffic is encrypted in transit over HTTPS. No unencrypted connections are accepted.

Invisible to Unauthorized Access

The API endpoint is designed to appear nonexistent unless valid credentials are provided. Invalid requests receive no indication that the API exists.

Example Request
GET /APIRequest
  ?tenantid=YOUR_TENANT_ID
  &key=YOUR_API_KEY
  &query=...

Ready to modernize your patient intake?

Join hundreds of healthcare practices that trust MedForward for HIPAA-compliant digital forms, document signing, and secure data integration.

No credit card required. Free onboarding included.