Reference·PV2 Segment·PV2-24
HL7 v2 Reference

Understanding HL7 v2 PV2-24: Patient Status in Practice

Jul 27, 2026 · 4 min read
← PV2-12

Patient Status looks like a simple status flag until you realize every source system in your integration landscape defines its own code table for it - and that mismatch is where interfaces quietly break.

Quick answer

PV2-24 carries a coded patient status value drawn from a user-defined or site-defined table rather than a single fixed HL7 code set - values like active, pending, discharged, or deceased are common, but the exact codes and their meanings vary by sending system. Because downstream systems frequently use this field as a trigger for state-machine logic (moving a record from "pending" to "active," for instance), it deserves more test coverage than its small size on the segment would suggest.

Valid code values

1
Home — common status/disposition value for a routine discharge to home
2
Transferred — patient moved to another facility or level of care
3
Deceased — end-of-encounter status requiring careful downstream handling
4
Active/Pending — encounter still in progress or awaiting confirmation
Note
Site-defined table — exact codes and meanings vary by sending system - always confirm the local table before assuming a value

Example

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

PV2-24 carries 1^HOME^HL70112 - a status code, its display text, and the table it was pulled from.

Where this trips people up

The single biggest mistake with Patient Status in test data is assuming the code values are portable across source systems. A "3" that means "deceased" in one facility's table might mean something entirely different in another's. Test suites that hardcode a single interpretation of PV2-24 values will pass against one source system and silently misclassify records from a second one. When generating synthetic data across multiple simulated source systems, vary both the codes and the tables they come from to catch that class of mapping bug early.

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
Test across multiple source-system code tables at once
Synthibase can simulate multiple source systems with distinct code tables for fields like PV2-24, so your interface gets validated against the real-world diversity it will face in production - not just one convenient convention.
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.