HL7 SPR SPR

HL7 field reference SPR fields from HL7 v2.5.1 Show fields

These are the generated fields for the version selected at the top of the page. The document stays the same, but the reference panel follows that version.

Fields

FieldNameRequiredRepeatableTypeTable
SPR.1 Query Tag No No ST
SPR.2 Query/Response Format Code Yes No ID 0106
SPR.3 Stored Procedure Name Yes No CE
SPR.4 Input Parameter List No Yes QIP

SPR carries a stored-procedure style query request.

Query segments define what the sender is asking for, how the receiver should format the answer, and how a multi-message response is continued or limited.

A query is an interface contract. The tag, parameters, row definitions, sort/filter rules, and continuation pointers must match exactly or the receiver may return technically valid data that is not what the requester expected.

The v2.5.1 structures show SPR in SPQ_Q08 - SPQ Q08. That tells you where it can appear, but the implementation guide still decides which optional fields are meaningful.

For practical interface work, read the generated field panel for datatype, required, repeatable, and table details, then use the notes below to decide what the field should mean in the receiving workflow.

SPR-1 Query Tag OptionalO SingleS TypeST

SPR-1 is the requester's handle for this query. Echoing it back correctly is what lets the requester match a response to the question it asked.

SPR-2 Query/Response Format Code RequiredR SingleS TypeID Table0106

SPR-2 tells the receiver what response style is expected. Use the values from HL7 table 0106 exactly as the profile defines them; changing the format changes how the rest of the response should be interpreted.

SPR-3 Stored Procedure Name RequiredR SingleS TypeCE

SPR-3 names the query, event, stored procedure, virtual table, or profile being invoked. This is the semantic switch for the query, so both sides need to agree on the allowed names and their parameter rules.

SPR-4 Input Parameter List OptionalO RepeatableR TypeQIP

SPR-4 carries the criteria or parameters that narrow the query. Keep each parameter in the expected datatype shape and avoid relying on display text that the receiver cannot evaluate.

Repeats should represent separate criteria or parameters in the order the query profile expects, not a free-form pile of search terms.

Related links