---
title: "Get HL7v2 Messages by Patient"
method: GET
path: "/hl7v2/patient/{particle_patient_id}"
tags: ["HL7v2"]
---

# Get HL7v2 Messages by Patient

`GET /hl7v2/patient/{particle_patient_id}`

## Request

- Base URL: `https://sandbox.particlehealth.com`
- URL: `https://sandbox.particlehealth.com/hl7v2/patient/{particle_patient_id}`
- Auth: API key in header `Authorization`

## Path parameters

- `particle_patient_id` string, required

## Response `200`

OK

- ApiHL7v2Messages
  - `messages` string[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2026-11-03** `b59a5413a488`: 4 info
  - added the optional property `error_code` to the response with the `400` status
  - added the optional property `error_code` to the response with the `401` status
  - added the optional property `error_code` to the response with the `406` status
  - added the optional property `error_code` to the response with the `500` status

[Operation history](https://skmtc.dev/particlehealth/apis/particle-health-api/changes/hl7v2/patient/:particle_patient_id/get.md)

---

[API](https://skmtc.dev/particlehealth/apis/particle-health-api.md) - [All operations](https://skmtc.dev/particlehealth/apis/particle-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/particlehealth/apis/particle-health-api/revisions/b59a5413a488?raw)