Reference·NK1 Segment·NK1-5
HL7 v2 Reference

What Is HL7 v2 NK1-5? Phone Number, Explained for Testers

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

An emergency contact number that a nurse can't dial because a stray extension code corrupted the number is the kind of NK1-5 bug that never shows up until someone actually needs to place the call.

Quick answer

NK1-5 holds a phone number for the associated party using the extended telecommunication number (XTN) data type, which can bundle a plain formatted number together with structured components like area code, local number, and extension. In practice, most sending systems only ever populate the free-text first component.

What this field contains

Component 1
Telephone Number — free-text formatted number, e.g. digits with or without punctuation; the component actually used in the vast majority of real messages
Component 6
Area/City Code — structured area code, populated only when the sending system fully decomposes the number
Component 7
Local Number — the subscriber number without area code
Component 8
Extension — optional extension digits, rare on next-of-kin numbers

Example

Synthetic example Generated by Synthibase
NK1|1|DOE^JANE^M|SPO|482 OAK ST^^DENVER^CO^80202|3035550142|||EC

The synthetic value 3035550142 is a plain, unformatted ten-digit number in the free-text component of NK1-5.

Where this trips people up

Because most real-world traffic only fills the free-text component, code that expects area code and local number to be broken out separately fails silently and falls back to an empty or malformed display. On top of that, formatting is inconsistent across sending systems — with dashes, without dashes, with a leading "1," or with international prefixes — so test coverage limited to one clean format will miss the reformatting bugs that show up the moment a second source system is connected.

HL7 v2 NK1 Segment Guide: Fields, Format, and Testing Gotchas
How to Write EDI Test Cases That Actually Catch Go-Live Failures
Healthcare API Testing Guide: FHIR and X12
Cover phone-format variance before it reaches production
Synthibase generates NK1-5 values across the formatting variations real systems actually send, so number parsing and display logic get exercised well 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.