Skip to main content
POST
/
v1
/
med-lists
/
from-documents
Extract a deduplicated medication list from clinical PDFs
curl --request POST \
  --url https://api.medlistiq.com/v1/med-lists/from-documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'external_patient_id=<string>'
{
  "medications": [
    {
      "display": "<string>",
      "drug_name": "<string>",
      "status": "<string>",
      "sources": [
        {
          "document_name": "<string>",
          "page": 2,
          "evidence_text": "<string>",
          "section": "Discharge Medications"
        }
      ],
      "rxnorm_code": "860975",
      "rxnorm_system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "dose": "500 mg",
      "route": "PO",
      "frequency": "BID",
      "status_conflict": false
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.medlistiq.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

MedListIQ API key (format: ml_...). Create one at Dashboard → API Keys.

Body

multipart/form-data
​
files
string[]
required
​
external_patient_id
string | null

Response

Successful Response

Body shape of POST /v1/med-lists/from-documents.

Body-only by design — request id, processing time, page counts, and ruleset version live in response headers (x-request-id, x-processing-time-ms, x-document-count, x-total-page-count, x-output-medication-count, x-ruleset-version).

​
medications
ExtractedMedication · object[]
required

Reconciled medication list. Ordered by the section recency of each medication's canonical mention, then alphabetically by drug name.