MedicationStatement

Represents a record of medication being taken by or administered to a patient, including dosage, frequency, and prescriber information.

Schema ID: https://vetformat.org/schemas/v1/medication-statement.schema.json

Fields

Field	Type	Required	Description
resource_type	"MedicationStatement"	Yes	Fixed resource type identifier for this schema.
id	string	Yes	Unique identifier for the medication statement record. UUID recommended.
patient_id	string	Yes	Reference to the patient taking or receiving the medication.
encounter_id	string	No	Reference to the encounter during which the medication was prescribed or recorded.
medication_name	string	Yes	Name of the medication.
medication_code	[medication_code]	No
status	enum	Yes	Current status of the medication usage.
date_started	string (date)	No	Date when the medication was started.
date_ended	string (date)	No	Date when the medication was stopped or completed.
dosage	[dosage]	No
reason	string	No	Clinical reason or indication for the medication.
prescriber_id	string	No	Reference to the practitioner who prescribed the medication. Must match an id in the top-level practitioners array.
notes	string	No	Additional notes about the medication statement.

status values

• active
• completed
• stopped
• on-hold

Sub-objects

medication_code object

Coded representation of the medication product.

Field	Type	Required	Description
system	string	Yes	The coding system used (e.g., ATC-vet, RxNorm, internal).
value	string	Yes	The medication code within the specified system.

dosage object

Dosage instructions for the medication.

Field	Type	Required	Description
value	number	Yes	Numeric dose amount per administration.
unit	string	Yes	Unit of the dose amount.
frequency	enum	Yes	How often the medication is administered.
frequency_text	string	No	Free-text frequency description when ‘other’ is selected or additional detail is needed.
route	enum	Yes	Route of administration.

dosage.frequency values

• once-daily
• twice-daily
• three-times-daily
• four-times-daily
• every-other-day
• once-weekly
• twice-weekly
• as-needed
• other

dosage.route values

• oral
• topical
• injection
• inhalation
• other

Full Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://vetformat.org/schemas/v1/medication-statement.schema.json",
  "title": "MedicationStatement",
  "description": "Represents a record of medication being taken by or administered to a patient, including dosage, frequency, and prescriber information.",
  "type": "object",
  "required": [
    "resource_type",
    "id",
    "patient_id",
    "medication_name",
    "status"
  ],
  "additionalProperties": false,
  "$defs": {
    "medication_code": {
      "type": "object",
      "description": "Coded representation of the medication product.",
      "properties": {
        "system": {
          "type": "string",
          "description": "The coding system used (e.g., ATC-vet, RxNorm, internal).",
          "examples": [
            "atc-vet"
          ]
        },
        "value": {
          "type": "string",
          "description": "The medication code within the specified system.",
          "examples": [
            "QJ01CA04"
          ]
        }
      },
      "required": [
        "system",
        "value"
      ],
      "additionalProperties": false
    },
    "dosage": {
      "type": "object",
      "description": "Dosage instructions for the medication.",
      "properties": {
        "value": {
          "type": "number",
          "description": "Numeric dose amount per administration.",
          "examples": [
            250
          ]
        },
        "unit": {
          "type": "string",
          "description": "Unit of the dose amount.",
          "examples": [
            "mg"
          ]
        },
        "frequency": {
          "type": "string",
          "enum": [
            "once-daily",
            "twice-daily",
            "three-times-daily",
            "four-times-daily",
            "every-other-day",
            "once-weekly",
            "twice-weekly",
            "as-needed",
            "other"
          ],
          "description": "How often the medication is administered."
        },
        "frequency_text": {
          "type": "string",
          "description": "Free-text frequency description when 'other' is selected or additional detail is needed.",
          "examples": [
            "every 8 hours with food",
            "before bedtime"
          ]
        },
        "route": {
          "type": "string",
          "enum": [
            "oral",
            "topical",
            "injection",
            "inhalation",
            "other"
          ],
          "description": "Route of administration.",
          "examples": [
            "oral"
          ]
        }
      },
      "required": [
        "value",
        "unit",
        "frequency",
        "route"
      ],
      "if": {
        "properties": {
          "frequency": {
            "const": "other"
          }
        },
        "required": [
          "frequency"
        ]
      },
      "then": {
        "required": [
          "value",
          "unit",
          "frequency",
          "route",
          "frequency_text"
        ]
      },
      "additionalProperties": false
    }
  },
  "properties": {
    "resource_type": {
      "const": "MedicationStatement",
      "description": "Fixed resource type identifier for this schema.",
      "examples": [
        "MedicationStatement"
      ]
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-zA-Z0-9._-]+$",
      "description": "Unique identifier for the medication statement record. UUID recommended.",
      "examples": [
        "med-550e8400-e29b-41d4-a716-446655440000"
      ]
    },
    "patient_id": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-zA-Z0-9._-]+$",
      "description": "Reference to the patient taking or receiving the medication.",
      "examples": [
        "550e8400-e29b-41d4-a716-446655440000"
      ]
    },
    "encounter_id": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-zA-Z0-9._-]+$",
      "description": "Reference to the encounter during which the medication was prescribed or recorded.",
      "examples": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ]
    },
    "medication_name": {
      "type": "string",
      "description": "Name of the medication.",
      "examples": [
        "Amoxicillin"
      ]
    },
    "medication_code": {
      "$ref": "#/$defs/medication_code"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "completed",
        "stopped",
        "on-hold"
      ],
      "description": "Current status of the medication usage.",
      "examples": [
        "active"
      ]
    },
    "date_started": {
      "type": "string",
      "format": "date",
      "description": "Date when the medication was started.",
      "examples": [
        "2025-06-15"
      ]
    },
    "date_ended": {
      "type": "string",
      "format": "date",
      "description": "Date when the medication was stopped or completed.",
      "examples": [
        "2025-06-29"
      ]
    },
    "dosage": {
      "$ref": "#/$defs/dosage"
    },
    "reason": {
      "type": "string",
      "description": "Clinical reason or indication for the medication.",
      "examples": [
        "Bacterial skin infection"
      ]
    },
    "prescriber_id": {
      "type": "string",
      "minLength": 1,
      "pattern": "^[a-zA-Z0-9._-]+$",
      "description": "Reference to the practitioner who prescribed the medication. Must match an id in the top-level practitioners array.",
      "examples": [
        "pract-001"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Additional notes about the medication statement.",
      "examples": [
        "Administer with food. Complete full 14-day course even if symptoms improve."
      ]
    }
  }
}