For AI agents: the documentation index is at /docs/payerbox/llms.txt. A Markdown version of this page is available at /docs/payerbox/data-integration/uscdi/service-requests.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Referrals and SDOH Interventions

Datasets

US Core 6.1.0 maps each USCDI element to FHIR.

DatasetUS Core 6.1.0 target profile(s)
service_requestsUS Core ServiceRequest

service_requests

One row per requested service: a referral, an order, or an SDOH intervention. This dataset carries the Reason for Referral and SDOH Interventions elements of the Procedures data class; the services actually performed go in procedures.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
statusYesdraft, active, on-hold, completed, revoked, entered-in-error, unknown request-statusactive
intentYesproposal, plan, directive, order, original-order, reflex-order, filler-order, instance-order, option request-intentorder
codeYesCPT, HCPCS, or SNOMED CT code, with code_system; CPT if omitted US Core Procedure Codes103696004 patient referral to specialist
categoryRecommendedone of the categories below, with category_system; SNOMED CT if omittedsdoh
reason_codeIf availableSNOMED CT or ICD-10-CM code(s), ;-separated, with reason_system; SNOMED CT if omitted US Core Condition Codes733423003 food insecurity
authored_onIf availabledatetime2026-05-10
occurrence_dateIf availabledatetime2026-05-24
requester_npiIf available10 digits1407006835
  • status and intent are both required bindings, so a value outside these lists is rejected. A referral a payer holds is normally active with intent order.
  • code says what was requested. It is the one coded field with no fallback: a row without it cannot become a ServiceRequest.
  • reason_code is why it was requested — the Reason for Referral element. For an SDOH intervention this is the need being addressed, such as food insecurity or lack of transport.
  • authored_on is when the request was written; occurrence_date is when the service should happen.
  • requester_npi must match a row in practitioners.

Categories

category is a required binding, so it takes one of these eleven values. Send category_system to say which system a code came from.

CodeMeaningcategory_system
sdohSDOHhttp://hl7.org/fhir/us/core/CodeSystem/us-core-category
functional-statusFunctional Statushttp://hl7.org/fhir/us/core/CodeSystem/us-core-category
cognitive-statusCognitive Statushttp://hl7.org/fhir/us/core/CodeSystem/us-core-category
disability-statusDisability Statushttp://hl7.org/fhir/us/core/CodeSystem/us-core-category
386053000Evaluation procedurehttp://snomed.info/sct
410606002Social service procedurehttp://snomed.info/sct
409063005Counsellinghttp://snomed.info/sct
409073007Educationhttp://snomed.info/sct
363679005Imaginghttp://snomed.info/sct
108252007Laboratory procedurehttp://snomed.info/sct
387713003Surgical procedurehttp://snomed.info/sct

Send sdoh on interventions that address a social need, whatever the service is. It is what marks the row as an SDOH intervention for the APIs that report on them.

These resources are served by Patient Access, Provider Access, Payer-to-Payer, and Prior Auth.

Last updated: