---
title: "GET /api/prescription_messages/{id}"
method: GET
path: "/api/prescription_messages/{id}"
tags: ["Clinical"]
---

# GET /api/prescription_messages/{id}

`GET /api/prescription_messages/{id}`

Retrieve an existing prescription message

## Path parameters

- `id` string, required

## Query parameters

- `parent_message` integer
- `since` string
- `patient` integer
- `doctor` integer

## Response `200`

OK

- PrescriptionMessage
  - `message_status` string — Message status for Incoming and Outgoing values. Success message for message_type are: `NewRx` : `Sent`, `RefillRequest` : `Received`, `RefillResponse` : `Sent`.
  - `patient` integer — An optional field which refers to a patient.
  - `doctor` integer
  - `message_type` string — Possible values are `NewRx` for outgoing new prescriptions, `RefillRequest` for incoming refill requests, `RefillResponse` for outgoing refill responses, `Error` for incoming errors, `Status` and `Verify` for incoming status reports from Surescripts.
  - `created_at` string
  - `parent_message` string — Refers to the parent message, used for refill responses and incoming error/status reports.
  - `message_direction` 'I' | 'O' — Possible values are `Outgoing` and `Incoming`.
  - `pharmacy` string — NCPDPID allocated #ID of the Pharmacy
  - `json_data` string — Data sent along with `NewRx`, `RefillRequest`, and `RefillResponses` messages. The format varies, but most likely it will contain `BenefitsCoordination` section with insurance info and `MedicationPrescribed` with medication info. `Patient`, `Pharmacy`, and `Prescriber` are also usually present.
  - `id` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Permission Denied
- `404` — Not Found
- `405` — Method Not Allowed
- `500` — Internal Server Error

---

[API](https://skmtc.net/drchrono/apis/untitled-api.md) · [All operations](https://skmtc.net/drchrono/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drchrono/untitled-api/versions/e595797fe800/schema)
