Home
API reference
FHIR® API
FHIR® notifications
Order
Service Request Updated

Service Request Updated Detailed

Page View

Order notifications contain details about any order placed by your connection's system to your organization. This could include device, medication, or service requests, depending on what your organization provides or manages for patients.

You can receive notifications when an order is created, cancelled, or updated.

updated

Indicates that your connection has updated an existing service request for a patient service or procedure that your organization provides or facilitates.

You can opt in for lightweight or detailed notifications.

  • A lightweight notification provides the ServiceRequest reference, procedure code, patient identifier, and timestamp.
  • A detailed notification contains everything in the lightweight plus extended patient info, encounter/provider info, and any related references.

Select payload example

ServiceRequestUpdatedFullBundleExample
json
1
{
2
  "resourceType": "Bundle",
3
  "id": "ServiceRequestUpdatedFullBundleExample",
4
  "type": "message",
5
  "entry": [
6
    {
7
      "resource": {
8
        "eventUri": "https://fhir.redoxengine.com/EventDefinition/ServiceRequestUpdated",
9
        "resourceType": "MessageHeader",
10
        "id": "ServiceRequestUpdatedMessageHeader",
11
        "source": {
12
          "name": "Good Health Clinics",
13
          "endpoint": "05107c08-fe2f-4740-8c1d-c7107d18ebe5"
14
        },
15
        "focus": [
16
          {
17
            "reference": "ServiceRequest/RedoxServiceRequestOrderExample"
18
          },
19
          {
20
            "reference": "Patient/RedoxPatientExampleTimothy"
21
          }
22
        ],
23
        "definition": "https://fhir.redoxengine.com/MessageDefinition/ServiceRequestUpdatedFull"
24
      }
25
    },
26
    {
27
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/ServiceRequest?identifier=6547891230|urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
28
      "resource": {
29
        "resourceType": "ServiceRequest",
30
        "id": "RedoxServiceRequestOrderExample",
31
        "identifier": [
32
          {
33
            "system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
34
            "value": "6547891230"
35
          }
36
        ],
37
        "intent": "order",
38
        "priority": "stat",
39
        "status": "active",
40
        "code": {
41
          "coding": [
42
            {
43
              "code": "49086-2",
44
              "system": "http://loinc.org",
45
              "display": "First trimester maternal screen with nuchal translucency panel"
46
            }
47
          ]
48
        },
49
        "authoredOn": "2022-08-08T08:00:00.000Z",
50
        "note": [
51
          {
52
            "text": "Additional information"
53
          }
54
        ],
55
        "reasonReference": [
56
          {
57
            "reference": "DocumentReference/RedoxDocumentReferenceExampleMediaTimothy"
58
          }
59
        ],
60
        "supportingInfo": [
61
          {
62
            "reference": "Observation/RedoxPlateletObservationExample"
63
          }
64
        ],
65
        "subject": {
66
          "reference": "Patient/RedoxPatientExampleTimothy"
67
        },
68
        "requester": {
69
          "reference": "Practitioner/RedoxPractitionerExamplePat"
70
        },
71
        "performer": [
72
          {
73
            "reference": "Practitioner/RedoxPractitionerExampleJoan"
74
          }
75
        ],
76
        "specimen": [
77
          {
78
            "reference": "Specimen/RedoxSpecimenExample"
79
          }
80
        ],
81
        "encounter": {
82
          "reference": "Encounter/RedoxEncounterExample"
83
        }
84
      }
85
    },
86
    {
87
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Patient?identifier=0000000001|urn:redox:MRN",
88
      "resource": {
89
        "resourceType": "Patient",
90
        "id": "RedoxPatientExampleTimothy",
91
        "meta": {
92
          "extension": [
93
            {
94
              "url": "https://fhir.redoxengine.com/StructureDefinition/example-sort-order",
95
              "valueInteger": 1
96
            }
97
          ]
98
        },
99
        "extension": [
100
          {
101
            "extension": [
102
              {
103
                "url": "text",
104
                "valueString": "White"
105
              }
106
            ],
107
            "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
108
          },
109
          {
110
            "extension": [
111
              {
112
                "url": "ombCategory",
113
                "valueCoding": {
114
                  "code": "2135-2",
115
                  "system": "urn:oid:2.16.840.1.113883.6.238",
116
                  "display": "Hispanic or Latino"
117
                }
118
              },
119
              {
120
                "url": "text",
121
                "valueString": "Hispanic"
122
              }
123
            ],
124
            "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
125
          }
126
        ],
127
        "identifier": [
128
          {
129
            "value": "0000000001",
130
            "system": "urn:redox:health-one:MR"
131
          },
132
          {
133
            "value": "101-01-0001",
134
            "system": "http://hl7.org/fhir/sid/us-ssn"
135
          }
136
        ],
137
        "name": [
138
          {
139
            "given": [
140
              "Timothy",
141
              "Paul"
142
            ],
143
            "family": "Bixby",
144
            "use": "official"
145
          },
146
          {
147
            "text": "Billy",
148
            "use": "usual"
149
          }
150
        ],
151
        "gender": "male",
152
        "birthDate": "2008-01-06",
153
        "telecom": [
154
          {
155
            "value": "+18088675301",
156
            "system": "phone",
157
            "use": "home"
158
          },
159
          {
160
            "value": "+18008675309",
161
            "system": "phone",
162
            "use": "work"
163
          },
164
          {
165
            "value": "timothy.bixby@redoxengine.com",
166
            "system": "email"
167
          }
168
        ],
169
        "address": [
170
          {
171
            "line": [
172
              "4762 Hickory Street"
173
            ],
174
            "city": "Monroe",
175
            "district": "Greene",
176
            "state": "WI",
177
            "postalCode": "53566",
178
            "country": "US",
179
            "use": "home"
180
          }
181
        ],
182
        "maritalStatus": {
183
          "coding": [
184
            {
185
              "code": "M",
186
              "system": "http://hl7.org/fhir/v3/MaritalStatus",
187
              "display": "Married"
188
            }
189
          ],
190
          "text": "Married"
191
        },
192
        "communication": [
193
          {
194
            "language": {
195
              "coding": [
196
                {
197
                  "code": "en",
198
                  "system": "urn:ietf:bcp:47"
199
                }
200
              ],
201
              "text": "English"
202
            }
203
          }
204
        ],
205
        "contact": [
206
          {
207
            "name": {
208
              "given": [
209
                "Barbara"
210
              ],
211
              "family": "Bixby"
212
            },
213
            "telecom": [
214
              {
215
                "value": "+18088675303",
216
                "system": "phone",
217
                "use": "home"
218
              },
219
              {
220
                "value": "barbara.bixby@redoxengine.com",
221
                "system": "email"
222
              }
223
            ],
224
            "address": {
225
              "line": [
226
                "4762 Hickory St."
227
              ],
228
              "city": "Monroe",
229
              "district": "Green",
230
              "state": "WI",
231
              "postalCode": "53566",
232
              "country": "USA"
233
            },
234
            "relationship": [
235
              {
236
                "coding": [
237
                  {
238
                    "code": "MTH",
239
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
240
                    "display": "mother"
241
                  }
242
                ],
243
                "text": "Mother"
244
              },
245
              {
246
                "coding": [
247
                  {
248
                    "code": "C",
249
                    "system": "http://terminology.hl7.org/CodeSystem/v2-0131",
250
                    "display": "Emergency Contact"
251
                  }
252
                ],
253
                "text": "Emergency Contact"
254
              }
255
            ]
256
          }
257
        ],
258
        "generalPractitioner": [
259
          {
260
            "reference": "Practitioner/RedoxPractitionerExamplePat"
261
          }
262
        ],
263
        "managingOrganization": {
264
          "reference": "Organization/RedoxOrganizationManagingExample"
265
        }
266
      }
267
    },
268
    {
269
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Encounter?identifier=zzz123Encounter|urn:redox:encounterId",
270
      "resource": {
271
        "resourceType": "Encounter",
272
        "id": "RedoxEncounterExample",
273
        "identifier": [
274
          {
275
            "system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.698084.11",
276
            "value": "9601346482"
277
          }
278
        ],
279
        "status": "finished",
280
        "class": {
281
          "code": "IMP",
282
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
283
          "display": "inpatient encounter"
284
        },
285
        "type": [
286
          {
287
            "coding": [
288
              {
289
                "code": "99222",
290
                "system": "http://www.ama-assn.org/go/cpt",
291
                "display": "InPatient Admission"
292
              }
293
            ]
294
          }
295
        ],
296
        "diagnosis": [
297
          {
298
            "condition": {
299
              "reference": "Condition/RedoxConditionExampleEncounterDx"
300
            }
301
          }
302
        ],
303
        "participant": [
304
          {
305
            "individual": {
306
              "reference": "Practitioner/RedoxPractitionerExampleEncounter"
307
            }
308
          }
309
        ],
310
        "location": [
311
          {
312
            "location": {
313
              "reference": "Location/RedoxLocationExampleEncounter"
314
            }
315
          }
316
        ],
317
        "subject": {
318
          "reference": "Patient/RedoxPatientExampleTimothy"
319
        },
320
        "period": {
321
          "start": "2022-02-06T04:00:00.000Z",
322
          "end": "2022-02-06T04:15:00.000Z"
323
        },
324
        "length": {
325
          "value": 16,
326
          "code": "m",
327
          "system": "http://unitsofmeasure.org"
328
        },
329
        "reasonCode": [
330
          {
331
            "coding": [
332
              {
333
                "code": "23360407",
334
                "system": "http://snomed.info/sct"
335
              }
336
            ],
337
            "text": "Pneumonia"
338
          }
339
        ]
340
      }
341
    },
342
    {
343
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Practitioner/RedoxPractitionerExamplePat",
344
      "resource": {
345
        "resourceType": "Practitioner",
346
        "id": "RedoxPractitionerExamplePat",
347
        "identifier": [
348
          {
349
            "system": "http://hl7.org/fhir/sid/us-npi",
350
            "value": "4356789876"
351
          }
352
        ],
353
        "name": [
354
          {
355
            "given": [
356
              "Pat"
357
            ],
358
            "family": "Granite"
359
          }
360
        ],
361
        "address": [
362
          {
363
            "line": [
364
              "123 Main St."
365
            ],
366
            "city": "Madison",
367
            "district": "Dane",
368
            "state": "WI",
369
            "postalCode": "53703",
370
            "country": "USA"
371
          }
372
        ],
373
        "telecom": [
374
          {
375
            "value": "+16085551234"
376
          }
377
        ]
378
      }
379
    },
380
    {
381
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Practitioner/RedoxPractitionerExampleJoan",
382
      "resource": {
383
        "resourceType": "Practitioner",
384
        "id": "RedoxPractitionerExampleJoan",
385
        "identifier": [
386
          {
387
            "system": "http://hl7.org/fhir/sid/us-npi",
388
            "value": "4336749876"
389
          }
390
        ],
391
        "name": [
392
          {
393
            "given": [
394
              "Joan"
395
            ],
396
            "family": "Fishman"
397
          }
398
        ],
399
        "address": [
400
          {
401
            "line": [
402
              "4762 Hickory St."
403
            ],
404
            "city": "Monroe",
405
            "district": "Green",
406
            "state": "WI",
407
            "postalCode": "53566",
408
            "country": "USA"
409
          }
410
        ],
411
        "telecom": [
412
          {
413
            "value": "+16085558899"
414
          }
415
        ]
416
      }
417
    },
418
    {
419
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Organization/RedoxOrganizationManagingExample",
420
      "resource": {
421
        "resourceType": "Organization",
422
        "id": "RedoxOrganizationManagingExample",
423
        "identifier": [
424
          {
425
            "value": "1234",
426
            "system": "urn:oid:1.2.3.4"
427
          }
428
        ],
429
        "active": true,
430
        "name": "Custodial Org",
431
        "address": [
432
          {
433
            "line": [
434
              "123 Main St"
435
            ],
436
            "city": "Madison",
437
            "state": "WI"
438
          }
439
        ],
440
        "telecom": [
441
          {
442
            "value": "1-800-123-4567",
443
            "system": "phone"
444
          }
445
        ],
446
        "type": [
447
          {
448
            "text": "Test Type"
449
          }
450
        ]
451
      }
452
    },
453
    {
454
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/DocumentReference?identifier=129.6.58.92.88336|urn:redox:test:media",
455
      "resource": {
456
        "resourceType": "DocumentReference",
457
        "id": "RedoxDocumentReferenceExampleMediaTimothy",
458
        "masterIdentifier": {
459
          "value": "129.6.58.92.88336",
460
          "system": "urn:redox:test:media",
461
          "extension": [
462
            {
463
              "url": "https://fhir.redoxengine.com/StructureDefinition/identifier-origin",
464
              "valueString": "RedoxApi"
465
            }
466
          ]
467
        },
468
        "subject": {
469
          "reference": "Patient/RedoxPatientExampleTimothy"
470
        },
471
        "status": "current",
472
        "description": "Test Description",
473
        "type": {
474
          "text": "Empty File"
475
        },
476
        "category": [
477
          {
478
            "coding": [
479
              {
480
                "system": "urn:redox:document_kind",
481
                "code": "Media"
482
              }
483
            ]
484
          }
485
        ],
486
        "context": {
487
          "period": {
488
            "start": "2015-05-06T06:00:58.872Z"
489
          }
490
        },
491
        "content": [
492
          {
493
            "attachment": {
494
              "data": "PC4uLmJhc2UgNjQgZmlsZSBjb250ZW50cy4uLj4=",
495
              "contentType": "application/pdf",
496
              "title": "SamplePDF-Order Specific Media"
497
            }
498
          }
499
        ]
500
      }
501
    },
502
    {
503
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Observation?identifier=4910481243|urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
504
      "resource": {
505
        "resourceType": "Observation",
506
        "id": "RedoxPlateletObservationExample",
507
        "category": [
508
          {
509
            "coding": [
510
              {
511
                "system": "http://terminology.hl7.org/CodeSystem/observation-category",
512
                "code": "laboratory"
513
              }
514
            ]
515
          }
516
        ],
517
        "identifier": [
518
          {
519
            "system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
520
            "value": "4910481243"
521
          }
522
        ],
523
        "status": "final",
524
        "subject": {
525
          "reference": "Patient/RedoxPatientExampleTimothy"
526
        },
527
        "basedOn": [
528
          {
529
            "reference": "ServiceRequest/RedoxServiceRequestOrderExample"
530
          }
531
        ],
532
        "code": {
533
          "coding": [
534
            {
535
              "code": "26515-7",
536
              "system": "http://loinc.org"
537
            }
538
          ],
539
          "text": "Platelets"
540
        },
541
        "specimen": {
542
          "reference": "Specimen/RedoxSpecimenExample"
543
        },
544
        "issued": "2022-02-16T17:26:19.778Z",
545
        "valueQuantity": {
546
          "value": 201,
547
          "unit": "10+3/ul"
548
        },
549
        "note": [
550
          {
551
            "text": "An observation result note"
552
          }
553
        ],
554
        "interpretation": [
555
          {
556
            "coding": [
557
              {
558
                "code": "N",
559
                "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationInterpretation",
560
                "display": "Normal"
561
              }
562
            ]
563
          }
564
        ]
565
      }
566
    },
567
    {
568
      "fullUrl": "https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/Specimen?identifier=123|urn:redox:example:SpecimenID",
569
      "resource": {
570
        "resourceType": "Specimen",
571
        "id": "RedoxSpecimenExample",
572
        "identifier": [
573
          {
574
            "system": "urn:redox:example:SpecimenID",
575
            "value": "123"
576
          }
577
        ],
578
        "subject": {
579
          "reference": "Patient/RedoxPatientExampleTimothy"
580
        },
581
        "type": {
582
          "coding": [
583
            {
584
              "code": "WB",
585
              "system": "http://terminology.hl7.org/CodeSystem/v2-0487",
586
              "display": "Blood, Whole"
587
            }
588
          ],
589
          "text": "Blood, Whole"
590
        },
591
        "collection": {
592
          "bodySite": {
593
            "text": "Left arm"
594
          },
595
          "collectedDateTime": "2022-02-14T19:20:02.762Z"
596
        }
597
      }
598
    }
599
  ],
600
  "timestamp": "2021-06-17T20:33:22.422Z"
601
}

Request Body Schema

    Bundle sent as part of a ServiceRequest-updated event

  • resourceType
    required, string

    Identifies the type of the resource

    Value: Bundle
  • type
    required, string

    Indicates the purpose of this bundle - how it is intended to be used.

    Value: message
  • entry
    required, Array of messageHeader, serviceRequest, patient, encounter

    An entry in the bundle containing a FHIR resource

    • fullUrl
      string

      The Absolute URL for the resource. The fullUrl SHALL NOT disagree with the id in the resource - i.e. if the fullUrl is not a urn:uuid, the URL shall be version-independent URL consistent with the Resource.id. The fullUrl is a version independent reference to the resource. The fullUrl element SHALL have a value except that:

      • fullUrl can be empty on a POST (although it does not need to when specifying a temporary id for reference in the bundle)
      • Results from operations might involve resources that are not identified.
    • resource
      object

      The Resource for the entry. The purpose/meaning of the resource is determined by the Bundle.type.

      • resourceType
        required, string

        Identifies the type of the resource

        Value: MessageHeader
      • source
        required, object

        The source application from which this message originated.

        • endpoint
          required, string

          Identifies the routing target to send acknowledgements to.

      • focus
        required, Array of object

        The actual data of the message - a reference to the root/focus class of the event.

        Must be a resource of type Resource.

        • reference
          string

          A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.

      • definition
        required, string

        Permanent link to the MessageDefinition for this message.

      • eventUri
        required, string

        Code that identifies the event this message represents and connects it with its definition. Events defined as part of the FHIR specification have the system value "http://terminology.hl7.org/CodeSystem/message-events". Alternatively uri to the EventDefinition.

        Value: https://fhir.redoxengine.com/EventDefinition/ServiceRequestUpdated
  • timestamp
    string

    The date/time that the bundle was assembled - i.e. when the resources were placed in the bundle.