Reference·PV2 Segment·PV2-3
HL7 v2 Reference

HL7 v2 PV2-3 (Admit Reason): Format, Values, and Testing Notes

Jul 27, 2026 · 4 min read
← PV2-2 PV2-7 →

Admit Reason is the field a human actually reads when they're trying to understand why a test encounter exists - so if your synthetic data leaves it blank or nonsensical, every downstream review takes longer.

Quick answer

PV2-3 records the reason a patient was admitted, expressed as a coded element that can carry a diagnosis code, a free-text description, or both together depending on how the sending system populates it. Unlike some administrative PV2 fields, Admit Reason tends to carry real clinical signal, so test data generators should populate it with values that are internally consistent with the rest of the encounter - a fractured wrist admit reason paired with a maternity accommodation code will get flagged by anyone reviewing results, and rightly so.

What this field contains

Component 1
Identifier — the coded value itself - often an ICD-10 or locally defined admit-reason code
Component 2
Text — human-readable description of the reason, useful even when the code alone is ambiguous
Component 3
Coding System — identifies which table or code system the value comes from (e.g., an ICD-10 identifier)

Example

Synthetic example Generated by Synthibase
PV2||A^SEMI-PRIVATE^HL70129|R65.2^ABDOMINAL PAIN RLQ^I10||||20260726073000|20260729120000||||20260724150000||||||||||||1^HOME^HL70112

PV2-3 carries R65.2^ABDOMINAL PAIN RLQ^I10 - a code, its text, and the coding system it was drawn from.

Where this trips people up

It's tempting to treat Admit Reason as a throwaway free-text field and fill it with lorem-ipsum-style placeholders. That works fine for parser-level unit tests, but it falls apart the moment the test data feeds a workflow that routes on diagnosis category, or a QA reviewer cross-checks it against the diagnosis segments elsewhere in the message. Keep Admit Reason plausible and consistent with the rest of the encounter, especially in any test suite that exercises clinical decision support or utilization review logic.

Testing HL7 v2 PV2: The Fields Your System Actually Needs to Handle
HL7 ADT Messages: A01 through A08 Explained
How to Build a Synthetic Patient Registry for Healthcare Testing
Build clinically coherent synthetic encounters
Synthibase generates PV2-3 and related clinical fields together so your synthetic admissions stay internally consistent - no more mismatched admit reasons and accommodations breaking manual review.
Start free trial →
This page is written independently by Synthibase for testing and informational purposes. It is not an official publication of HL7 International or X12/Washington Publishing Company, and is not a substitute for reviewing the official standard or your trading partner's companion guide. See our Terms of Service for full legal terms.