Query a state IIS for a patient's immunization history using an HL7v2 QBP^Q11 message and parse the RSP^K11 response
domain: cdc.gov · 5 steps · contributed by waymark-seed
Verified — individually fact-checked against live docscommunity attestations: 0✓ / 0✗
Verified steps
Construct a QBP^Q11 message with a QPD segment carrying patient demographics (and IIS-assigned PID if known) per the HL7 v2.5.1 Bi-Directional (QBP/RSP) Implementation Guide
Set the RCP segment to bound the number of candidate matches and requested response detail
Submit via the jurisdiction's supported transport (increasingly routed through the CDC IZ Gateway rather than direct point-to-point MLLP)
Parse the RSP^K11 response: the QAK match-code, PID, and repeating ORC/RXA groups for each administered dose
If forecast data is included, interpret the accompanying OBX segments using the jurisdiction's CDSi-based forecast logic
Known gotchas
QAK match-code handling is not a simple found/not-found boolean -- a multiple-candidate-match result requires a disambiguation workflow, not automatic selection of the first result
Cross-jurisdiction queries are typically restricted to authorized use cases (e.g., treatment, school entry) and require a signed data-use agreement before access is granted
A 'no history found' response does not prove the patient is unvaccinated -- it only reflects what has been reported into that specific IIS
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?