Prescription API
Get prescription
Retrieve the details of a specific prescription.
GET
/prescriptions/{id}OAuth 2.0prescriptions.read200 OKAuthentication
OAuth 2.0
Required
Permissions
prescriptions.read
Required
Rate limit
600 requests / min
Default
Caching
30 seconds
Recommended
Response
200 OK
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | Prescription identifier |
Example request
cURL
curl -X GET "https://api.mediloop.com/v1/prescriptions/presc_456" \
-H "Authorization: Bearer $ACCESS_TOKEN"Example response
200 OK{
"data": {
"id": "presc_456",
"status": "signed",
"patient_id": "pat_123",
"items": [{"medication_code":"AMOX500","dose":"500mg"}]
}
}Example response
Responses use stable identifiers and lifecycle status values so clients can safely coordinate clinical and pharmacy workflows.
Responses
| HTTP | Description |
|---|---|
| 200 | Request completed successfully |
| 201 | Resource/action created |
| 400 | Validation error |
| 401 | Authentication required |
| 403 | Insufficient permission or scope |
| 404 | Prescription not found |
| 409 | Lifecycle or concurrency conflict |
| 422 | Unprocessable clinical/request data |
Prescription model
| Field | Meaning |
|---|---|
| id | Prescription identifier |
| patient_id | Patient reference |
| prescriber_id | Prescriber reference |
| encounter_id | Related encounter |
| status | Lifecycle status |
| items | Prescribed medication items |
| notes | Clinical / pharmacy note |
| signed_at | Signature timestamp |
| routed_pharmacy_id | Destination pharmacy |
| created_at | Creation timestamp |
Status values
| Status | Meaning |
|---|---|
| draft | Created and editable by the prescriber |
| clinically_validated | Clinical checks completed |
| signed | Immutable signed snapshot created |
| routed | Sent to a pharmacy |
| dispensed | Medication dispensation recorded |
| cancelled | Cancelled before completion |
Workflow
draftCreated by provider
clinically_validatedClinically validated
signedDigitally signed
routedSent to pharmacy
dispensedDispensed to patient