Build the 278 request (005010X217): ISA/GS envelope, ST*278 with BHT*0007 (request), Loop 2000A utilization management organization loop, Loop 2000B requester loop, Loop 2000C subscriber loop with member demographics and insurance info, Loop 2000D patient loop if different from subscriber
In Loop 2000E (service loop) populate UM segment: UM01 request category code (HS=health services review, SC=specialty care review), UM02 certification type (1=initial, 2=renewal), UM09 service type code; include HCR segment for health care review information
Add SV1 (professional) or SV2 (institutional) service line segments with procedure codes, diagnosis pointers linking to HI segments, and requested units; attach DTP segments for anticipated service dates
Submit to the payer or clearinghouse endpoint; an immediate 278 response with AAA=approved or a HCR pend code may return synchronously, or the payer may return a pending acknowledgment and respond asynchronously
If response HCR01 is 'A1' (approved) extract the authorization number from REF*BB and store it for claim submission; if 'A3' (not medically necessary) or 'A4' (denied) capture the reason codes from HCR and plan appeal
For pended responses poll the status endpoint or await an unsolicited 278 response; match on the TRN trace number from the original request
Known gotchas
278 transaction requirements vary significantly by payer — some require clinical notes as attachments (X12 275 or FHIR DocumentReference) while others accept the structured segments alone; check the payer companion guide before assuming a minimal payload is sufficient
The authorization number returned in REF*BB must be included in CLM segment CLM05-3 (facility type code context) and in a REF*G1 segment on the 837 claim; missing this causes claim denial for missing auth
Real-time 278 responses are not universally supported; many payers still require a human review queue for inpatient requests with turnaround times measured in hours to days
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp