# CreateMedicationRequest

Model ID: `CreateMedicationRequest`

Request body for POST /patients/medications.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `authored_on` | `string|null` | No |  |  |  | Yes | Date the order was authored. |
| `brand_name` | `string|null` | No |  |  |  | Yes | Brand name, when different from `name`. |
| `discontinued_reason` | `string|null` | No |  |  |  | Yes | Reason the medication was discontinued, when applicable. |
| `dosage` | [`patient.Dosage`](./patient.Dosage.md) | Yes |  |  |  | No | Dosage value, unit, frequency, and related instructions. |
| `encounter_id` | `string|null` | No |  |  |  | Yes | FHIR Encounter resource ID this medication was ordered during, when applicable. |
| `end_date` | `string|null` | No |  |  |  | Yes | Date the medication ends, when known; must be on or after start_date. |
| `generic_name` | `string|null` | No |  |  |  | Yes | Generic name, when different from `name`. |
| `indication` | `string|null` | No |  |  |  | Yes | Clinical reason the medication was prescribed. |
| `intent` | [`MedicationIntent`](./MedicationIntent.md) | No |  |  |  | No | FHIR MedicationRequest intent. Defaults to `order` when omitted. |
| `name` | `string` | Yes |  |  |  | No | Generic or brand medication name. |
| `ndc_code` | `string|null` | No |  |  |  | Yes | National Drug Code, when RxNorm is unavailable. |
| `notes` | `string|null` | No |  |  |  | Yes | Free-text clinical notes. |
| `pharmacy` | `string|null` | No |  |  |  | Yes | Dispensing pharmacy name. |
| `prescriber_name` | `string|null` | No |  |  |  | Yes | Display name of the prescribing practitioner. |
| `refills_authorized` | `integer|null` | No |  |  |  | Yes | Total refills authorized. |
| `refills_remaining` | `integer|null` | No |  |  |  | Yes | Refills remaining. |
| `resource_type` | [`MedicationResourceType`](./MedicationResourceType.md) | No |  |  |  | No | FHIR resource type to store the medication as. Defaults to `MedicationRequest` when omitted. |
| `route` | [`MedicationRoute`](./MedicationRoute.md) | Yes |  |  |  | No | Route of administration. |
| `rxnorm_code` | `string|null` | No |  |  |  | Yes | RxNorm code identifying the medication. |
| `start_date` | `string|null` | No |  |  |  | Yes | Date the patient is to start taking the medication. |
| `status` | [`MedicationStatus`](./MedicationStatus.md) | No |  |  |  | No | Medication status. Defaults to `active` when omitted. |

## Example

None declared in canonical OpenAPI.