Reference·SCH Segment·SCH-7
HL7 v2 Reference

What Is HL7 v2 SCH-7? Appointment Reason, Explained for Testers

Jul 27, 2026 · 4 min read
← SCH-2 SCH-9 →

SCH-7 answers the question every scheduling clerk asks first: why is this patient coming in? It sounds simple until you realize the reason can be coded, free text, or both — and every site codes it differently.

Quick answer

SCH-7 (Appointment Reason) describes why the appointment is being scheduled, using a coded-element structure that can carry an identifier, a human-readable text description, and the name of the coding system the identifier belongs to.

What this field contains

Component 1
Identifier — a short code representing the reason, such as a local abbreviation for a follow-up or new-patient visit
Component 2
Text — the human-readable description of the reason, often what actually gets displayed on a scheduler's screen
Component 3
Coding System — identifies which code table the identifier comes from — most sites use a locally defined table rather than a national standard

Example

Synthetic example Generated by Synthibase
SCH|APT88213^SYNTHIB|FIL55021^SYNTHIB|||||FOLLOWUP^Follow-up Visit^SYNTHIBLOCAL|OFFICE^Office Visit^SYNTHIBLOCAL|30|MIN|^^^20260728090000^20260728093000||||||||||||||SCHEDULED^Scheduled^SYNTHIBLOCAL

SCH-7 in this synthetic message is FOLLOWUP^Follow-up Visit^SYNTHIBLOCAL — a made-up local reason code, its text, and a fictional coding-system name.

Where this trips people up

Because most organizations maintain their own reason-code tables instead of using a shared national list, test data built against one facility's code set will fail validation against another's. A synthetic dataset that hardcodes a single site's SCH-7 values can pass every internal test and still break the moment it's pointed at a different facility's scheduling system.

HL7 v2 SCH Segment Guide: Fields, Format, and Testing Gotchas
Healthcare API Testing Guide: FHIR and X12
HL7 ADT Messages: A01 through A08 Explained
Cover every reason code your sites actually use
Synthibase lets you model facility-specific reason-code tables into your synthetic SCH-7 values, so test coverage matches the coding variety your interfaces will see across every connected site.
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.