---
title: "Process HL7 Message"
method: POST
path: "/v1/hl7"
tags: ["HL7"]
---

# Process HL7 Message

`POST /v1/hl7`

Process incoming HL7 messages from EHR systems. Accepts JSON with "message" field, raw text/plain HL7 content, or form-encoded data.

## Request body

- object — HL7 message data. For JSON: use "message" field. For text/plain: send raw HL7. For form-encoded: include message field.
  - `message` union — HL7 message content - the primary way to send HL7 data
    - string
    - object
  - `f` string — Form field (legacy support)
  - `interface` string — Interface identifier (legacy support)
  - `login_user` string — Login user (legacy support)
  - `login_passwd` string — Login password (legacy support)
  - `message_b64` string — Base64 encoded HL7 message (legacy support)

## Response `200`

HL7 ACK message

- string — HL7 ACK message

## Other responses

- `400` — Default Response
- `500` — Default Response
- `503` — HL7 AR ACK message (transient failure - safe to retry)

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)