---
title: "GET /api/prescription_messages_list"
method: GET
path: "/api/prescription_messages_list"
tags: ["Clinical"]
---

# GET /api/prescription_messages_list

`GET /api/prescription_messages_list`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/prescription_messages_list`
- Auth: OAuth 2
  - Authorization code: `https://app.drchrono.com/o/authorize/`
  - Token URL: `https://app.drchrono.com/o/token/` scopes: `clinical:read`

Retrieve or search prescription messages in batches. Results returned in order of ID or updated_at.

## Query parameters

- `uuid` string

## Response `200`

OK

- object: Paginated Result
  - `status` string: Status of the request. Possible values are "Complete" or "In progress".
  - `pagination` object: information on the total pages, current page and total count.
    - `count` unknown
    - `pages` unknown
    - `page` unknown
  - `results` PrescriptionMessage[]: result data. only presented when the status is "Complete"
    - `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
  - `uuid` string: UUID of the batch.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Permission Denied
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/drchrono/apis/drchrono-api.md) - [All operations](https://skmtc.dev/drchrono/apis/drchrono-api/llms.txt) - [OpenAPI document](https://skmtc.dev/drchrono/apis/drchrono-api/revisions/98cabe79d150?raw)