Reference·GT1 Segment·GT1-1
HL7 v2 Reference

HL7 v2 GT1-1 (Set ID): Format, Values, and Testing Notes

Jul 27, 2026 · 4 min read
GT1-3 →

GT1-1 looks trivial — it is just a counter — but it is the field that tells a billing system whether it is looking at one guarantor or several, and generators that hardcode it to "1" quietly break multi-guarantor test scenarios.

Quick answer

GT1-1 is a sequential number identifying each GT1 segment when a message carries more than one guarantor for the same account. The first guarantor is 1, the second is 2, and so on. It has no meaning beyond ordering and uniqueness within the message.

What this field contains

Format
Numeric string — typically a plain integer starting at 1, incrementing for each additional GT1 segment in the message
Cardinality
Required in practice — most receiving systems expect it populated even though its absence rarely causes an outright rejection
Common failure
Duplicate or reset values — generators that always emit "1" hide bugs in systems meant to handle multiple guarantors per account

Example

Synthetic example Generated by Synthibase
GT1|1||DOE^JOHN^R||482 OAK ST^^DENVER^CO^80202|3035550142|||||01|123-45-6789

GT1-1 is the "1" immediately after the segment name, marking this as the first (and here, only) guarantor on the account.

Where this trips people up

Single-guarantor test messages make it easy to forget this field ever changes. When accounts with a primary and secondary guarantor show up in production, the receiving application has to iterate over multiple GT1 segments and use the Set ID to keep them in order or to update a specific one during a follow-up message. If your test data never produces a message with GT1-1 values of 1 and 2 together, that iteration logic is untested.

HL7 v2 GT1 Segment Guide: Fields, Format, and Testing Gotchas
How to Build a Synthetic Patient Registry for Healthcare Testing
HL7 ADT Messages: A01 through A08 Explained
Test multi-guarantor scenarios with confidence
Synthibase can generate accounts with multiple synthetic guarantors and correctly sequenced GT1 segments, so your ordering and update logic gets exercised before go-live.
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.