Skip to main content
Send a POST request to create a medication definition. Medications represent the drug itself — not a prescription or order. You must provide code, which can be a free-text string or a fully coded concept using RxNorm, SNOMED CT, or another terminology. To prescribe a medication to a patient, use the Prescriptions API.

​
Request

​
code
string | object
required
Drug identification code. Pass a plain string for a free-text name (e.g. "Amoxicillin 500mg Capsule"), or an object with system, code, and display for a coded reference such as RxNorm.
​
status
string
Availability status of the medication. One of: active, inactive. Defaults to active.
​
form
string
Dosage form of the medication, e.g. capsule, tablet, liquid. Maximum 100 characters.
​
ingredient
array
List of active and inactive ingredients. Each ingredient has an item (coded concept), isActive flag, and optional strength.
​
batch
object
Batch or lot information for inventory tracking.

​
Example

curl -X POST https://api.clinikapi.com/v1/medications \
  -H "x-api-key: clk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "code": {
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "code": "308182",
      "display": "Amoxicillin 500 MG Oral Capsule"
    },
    "status": "active",
    "form": "capsule",
    "ingredient": [
      {
        "item": {
          "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
          "code": "723",
          "display": "Amoxicillin"
        },
        "isActive": true,
        "strength": {
          "numerator": { "value": 500, "unit": "mg" },
          "denominator": { "value": 1, "unit": "capsule" }
        }
      }
    ],
    "batch": {
      "lotNumber": "LOT-2025-A001",
      "expirationDate": "2026-12-31"
    }
  }'

​
Response

Returns the created medication object.
​
id
string
Unique identifier for the medication, prefixed med_.
​
code
string | object
Drug code or free-text name.
​
status
string
active or inactive.
​
form
string
Dosage form.
​
ingredient
array
Ingredient list with item, isActive, and strength.
​
batch
object
Batch information with lotNumber and expirationDate.
​
createdAt
string
ISO 8601 datetime when the record was created.
Example response
{
  "data": {
    "id": "med_abc123",
    "code": {
      "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
      "code": "308182",
      "display": "Amoxicillin 500 MG Oral Capsule"
    },
    "status": "active",
    "form": "capsule",
    "ingredient": [
      {
        "item": {
          "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
          "code": "723",
          "display": "Amoxicillin"
        },
        "isActive": true,
        "strength": {
          "numerator": { "value": 500, "unit": "mg" },
          "denominator": { "value": 1, "unit": "capsule" }
        }
      }
    ],
    "batch": {
      "lotNumber": "LOT-2025-A001",
      "expirationDate": "2026-12-31"
    },
    "createdAt": "2025-01-15T10:00:00Z"
  },
  "meta": {
    "requestId": "req_w8o1i5f0",
    "timestamp": "2025-01-15T10:00:00Z",
    "status": 201,
    "rateLimitTotal": 1000,
    "rateLimitRemaining": 997,
    "rateLimitReset": 60
  }
}
Medications represent drug definitions, not prescriptions. To order a medication for a patient, create a Prescription that references this medication.