Skip to main content
1

Get an API key

Sign up for free, create an organization, then go to Dashboard → API Keys and click Create key. The full key is shown exactly once — copy it before closing the dialog.Free tier: 100 requests/month, 10/min. Enough for a real integration test.
2

Make a request

Replace ml_test_YOUR_KEY with the key you just minted.
curl -X POST https://api.medlistiq.com/v1/medications/infer \
  -H 'Authorization: Bearer ml_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      {
        "resourceType": "MedicationRequest",
        "id": "mr-1",
        "status": "active",
        "intent": "order",
        "authoredOn": "2026-03-05",
        "medicationCodeableConcept": {
          "coding": [{
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "617312",
            "display": "Atorvastatin 40 MG Oral Tablet"
          }]
        }
      },
      {
        "resourceType": "MedicationDispense",
        "id": "md-1",
        "status": "completed",
        "whenHandedOver": "2026-04-09",
        "medicationCodeableConcept": {
          "coding": [{
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "617312",
            "display": "Atorvastatin 40 MG Oral Tablet"
          }]
        }
      }
    ]
  }'
3

Read the response

{
  "medications": [
    {
      "display_name": "Atorvastatin 40 MG Oral Tablet",
      "status": "active",
      "confidence": 0.95,
      "sig": "Take 1 tablet by mouth daily",
      "indication": null
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-...",
    "ruleset_version": "2026-04-15.v5",
    "as_of": "2026-04-18T12:00:00Z",
    "processing_time_ms": 187,
    "input_resource_count": 2,
    "output_medication_count": 1
  }
}
The order and the recent dispense were deduplicated into one active medication. Confidence is high because the two signals corroborate.

​
Next

Understanding the output

Every field, every status, and how confidence should be interpreted.

Verbosity levels

minimal, standard, full — pick the payload shape that fits.

Using `as_of`

Pin evaluation time for reproducible results.

API reference

Full schema, every parameter, all error codes.