---
title: "Submit medication data for multiple patients"
method: POST
path: "/api/v1/medications"
tags: ["Partner API v1"]
---

# Submit medication data for multiple patients

`POST /api/v1/medications`

## Request

- Base URL: `https://api.hippocraticai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hippocraticai.com/api/v1/medications`
- Auth: HTTP bearer

Submit medication data for multiple patients.

Use this endpoint to submit a standalone medication list for patients already registered via `/contacts`.
Each entry is matched by MRN. For submitting medications alongside a new or updated contact record,
use the `/contacts` endpoint with the `medications` field instead.

**Authentication:**
This endpoint supports dual authentication methods:
- **Auth0 JWT Bearer Token**: For partners using Auth0 authentication
  - Header: `Authorization: Bearer <JWT_TOKEN>`
  - Token must include `partner_id` claim
  - Token is validated for signature, expiration, issuer, and audience

- **Verification Token**: For partners using legacy authentication
  - Header: `verification-token: <ENCRYPTED_TOKEN>`
  - Token format: `partner_id:verification_token` (encrypted)
  - Validated against partner credentials

Your partner account is configured for one of these methods. Please use the authentication method assigned to your account.
If you attempt to use the wrong method, you will receive a 401 Unauthorized error.

**Response Codes:**
- `201 Created`: Successfully processed medication data
- `401 Unauthorized`: Authentication failed or wrong authentication method used
- `400 Bad Request`: Invalid request payload
- `500 Internal Server Error`: Server error during processing

## Request body

- MedicationRequestEntry[]: List of medication entries
  - `mrn` string, required: Medical record number (MRN)
  - `medications` SrcExternalApiSchemasProductV1MedicationRequestMedicationRequest[], required: List of medications for the patient
    - `medication` string, required: Name of the medication
    - `prescription` string, required: Prescription details including dosage and frequency
    - `status` string, required: Status of the medication (active, discontinued, completed)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hippocraticai/apis/hippocratic-ai-agent-api-suite.md) - [All operations](https://skmtc.dev/hippocraticai/apis/hippocratic-ai-agent-api-suite/llms.txt) - [OpenAPI document](https://skmtc.dev/hippocraticai/apis/hippocratic-ai-agent-api-suite/revisions/c2472c92766c?raw)