Interview-prep sandbox

Prior Auth Integration Lab

Learn how HL7 v2 pipe-delimited clinical messages and X12 278 EDI service-review transactions can be parsed, validated, debugged, and mapped into one normalized prior-authorization API payload.

HL7 v2

Segmented clinical messaging used by EHRs for ADT, orders, results, and operational events.

X12 278R

EDI request/response data flow for health care services review, prior authorization, and payer status reconciliation.

275 attachments

Supporting documentation workflows that must correlate clinical documents back to the authorization transaction.

Normalized model

A stable internal API shape that lets integration logic decouple from source-specific formats.

Hands-on parsing

HL7 v2 ADT-like parser

Parsed segment tree

[
  {
    "name": "MSH",
    "fields": [
      "^~\\&",
      "EPIC",
      "GOODHEALTH",
      "AUTHLAB",
      "HUMATA",
      "202605071230",
      "",
      "ADT^A04",
      "MSG00001",
      "P",
      "2.5.1"
    ],
    "raw": "MSH|^~\\&|EPIC|GOODHEALTH|AUTHLAB|HUMATA|202605071230||ADT^A04|MSG00001|P|2.5.1"
  },
  {
    "name": "PID",
    "fields": [
      "1",
      "",
      "MRN12345^^^GOODHEALTH^MR",
      "",
      "DOE^JANE^A",
      "",
      "19850714",
      "F",
      "",
      "",
      "123 MAIN ST^^DENVER^CO^80202",
      "",
      "3035550111",
      "",
      "",
      "",
      "",
      "MEM987654"
    ],
    "raw": "PID|1||MRN12345^^^GOODHEALTH^MR||DOE^JANE^A||19850714|F|||123 MAIN ST^^DENVER^CO^80202||3035550111|||||MEM987654"
  },
  {
    "name": "PV1",
    "fields": [
      "1",
      "O",
      "CARD^101^1^GH",
      "",
      "",
      "1234567890^HOUSE^GREGORY",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "V123456",
      "SELF",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "202605071200"
    ],
    "raw": "PV1|1|O|CARD^101^1^GH|||1234567890^HOUSE^GREGORY|||||||||||V123456|SELF|||||||||||||||||||||||||202605071200"
  },
  {
    "name": "IN1",
    "fields": [
      "1",
      "PLAN42",
      "PAY123",
      "ACME HEALTH PLAN",
      "1 PAYER WAY^^DENVER^CO^80202",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "",
      "DOE^JANE",
      "SELF",
      "19850714"
    ],
    "raw": "IN1|1|PLAN42|PAY123|ACME HEALTH PLAN|1 PAYER WAY^^DENVER^CO^80202|||||||||||DOE^JANE|SELF|19850714"
  }
]

Normalized prior-auth JSON

{
  "sourceType": "HL7_V2",
  "patient": {
    "lastName": "DOE",
    "firstName": "JANE",
    "dateOfBirth": "1985-07-14",
    "sex": "F",
    "mrn": "MRN12345",
    "memberId": "MEM987654"
  },
  "payer": {
    "name": "ACME HEALTH PLAN",
    "payerId": "PAY123"
  },
  "provider": {
    "name": "GREGORY HOUSE",
    "npi": "1234567890"
  },
  "request": {
    "requestType": "Admission/visit notification used as prior-auth intake seed",
    "diagnosisCodes": [],
    "procedureCodes": [],
    "status": "Parsed from HL7 ADT-like sample"
  },
  "metadata": {
    "messageControlId": "MSG00001",
    "receivedAt": "2026-05-07T03:07:22.640Z",
    "validationErrors": [
      "At least one diagnosis code or procedure/service code is required."
    ],
    "warnings": [
      "HL7 ADT messages usually start an intake workflow; clinical codes may arrive in other segments/messages or downstream APIs.",
      "Service date is missing; many payers require it for prior authorization."
    ]
  }
}