Home
API reference
FHIR® API
FHIR® resources
Appointment
$referral-schedule-update

Appointment $referral-schedule-update

post/Appointment/$referral-schedule-update
Page View

This resource contains entries with a patient, provider, or location schedule. Each appointment entry contains the status, participants, date/time, and other details. 

For standard FHIR®, you can review, retrieve, create, update, or cancel appointment information.

For 360x workflows, you can update appointment information for a referred patient service or procedure.

Supported fields and schema examples

We support any valid FHIR® field. However, we only display fields we’ve defined in our schema, which are usually based on what’s included in the U.S. Core profile. We recommend relying on U.S. Core requirements.

Our schema examples show the shape and possibility of each FHIR® resource; they aren’t code for real-time API calls. We don’t currently recommend copying and pasting these schema examples for your API calls. Consider reviewing FHIR® API actions for realistic examples for particular use cases.

$referral-schedule-update

Open beta feature

This is an open beta feature, which means you won’t see it available in your organization until you opt in. If you’re interested in joining this beta, talk to a Redoxer to find out if you’d be a good fit.

Update a referral request from your connection with a scheduling change for a referred patient service or procedure.

At a minimum, this operation should include this bundle of resources:

Required

  • Appointment
  • Patient

Optional

  • Location
  • Organization
  • Practitioner
  • ServiceRequest

Request parameters and payload

cURL request example

bash
1
curl 'https://api.redoxengine.com/fhir/R4/{destinationSlug}/{environmentFlag}/Appointment/$referral-schedule-update' \
2
--request POST \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'Content-Type: application/fhir+json' \
5
--data '{
6
  "resourceType": "Bundle",
7
  "id": "RedoxReferralScheduleUpdateBundleExample",
8
  "type": "message",
9
  "entry": [
10
    {
11
      "resource": {
12
        "eventUri": "https://fhir.redoxengine.com/EventDefinition/ReferralScheduleUpdate",
13
        "resourceType": "MessageHeader",
14
        "id": "28135b14-767d-5f31-b7ee-8eb4113d2a7d",
15
        "source": {
16
          "name": "Good Health Clinics",
17
          "endpoint": "urn:uuid:05107c08-fe2f-4740-8c1d-c7107d18ebe5"
18
        },
19
        "focus": [
20
          {
21
            "reference": "urn:uuid:724c33ec-2490-5ae5-8bba-7ab1e65dcc54"
22
          }
23
        ]
24
      },
25
      "fullUrl": "urn:uuid:28135b14-767d-5f31-b7ee-8eb4113d2a7d"
26
    },
27
    {
28
      "fullUrl": "urn:uuid:724c33ec-2490-5ae5-8bba-7ab1e65dcc54",
29
      "resource": {
30
        "resourceType": "Appointment",
31
        "id": "724c33ec-2490-5ae5-8bba-7ab1e65dcc54",
32
        "participant": [
33
          {
34
            "status": "accepted",
35
            "actor": {
36
              "reference": "urn:uuid:627827ad-21bc-56c8-ab24-4218486ea588"
37
            }
38
          }
39
        ],
40
        "status": "booked",
41
        "start": "2025-10-15T14:00:00Z",
42
        "end": "2025-10-15T14:30:00Z",
43
        "basedOn": [
44
          {
45
            "reference": "ServiceRequest/example-referral"
46
          }
47
        ]
48
      }
49
    },
50
    {
51
      "fullUrl": "urn:uuid:627827ad-21bc-56c8-ab24-4218486ea588",
52
      "resource": {
53
        "resourceType": "Patient",
54
        "id": "627827ad-21bc-56c8-ab24-4218486ea588",
55
        "meta": {
56
          "extension": [
57
            {
58
              "url": "https://fhir.redoxengine.com/StructureDefinition/example-sort-order",
59
              "valueInteger": 1
60
            }
61
          ]
62
        },
63
        "extension": [
64
          {
65
            "extension": [
66
              {
67
                "url": "text",
68
                "valueString": "White"
69
              }
70
            ],
71
            "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-race"
72
          },
73
          {
74
            "extension": [
75
              {
76
                "url": "ombCategory",
77
                "valueCoding": {
78
                  "code": "2135-2",
79
                  "system": "urn:oid:2.16.840.1.113883.6.238",
80
                  "display": "Hispanic or Latino"
81
                }
82
              },
83
              {
84
                "url": "text",
85
                "valueString": "Hispanic"
86
              }
87
            ],
88
            "url": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity"
89
          }
90
        ],
91
        "identifier": [
92
          {
93
            "value": "0000000001",
94
            "system": "urn:redox:health-one:MR"
95
          },
96
          {
97
            "value": "101-01-0001",
98
            "system": "http://hl7.org/fhir/sid/us-ssn"
99
          }
100
        ],
101
        "name": [
102
          {
103
            "given": [
104
              "Timothy",
105
              "Paul"
106
            ],
107
            "family": "Bixby",
108
            "use": "official"
109
          },
110
          {
111
            "text": "Billy",
112
            "use": "usual"
113
          }
114
        ],
115
        "gender": "male",
116
        "birthDate": "2008-01-06",
117
        "telecom": [
118
          {
119
            "value": "+18088675301",
120
            "system": "phone",
121
            "use": "home"
122
          },
123
          {
124
            "value": "+18008675309",
125
            "system": "phone",
126
            "use": "work"
127
          },
128
          {
129
            "value": "timothy.bixby@redoxengine.com",
130
            "system": "email"
131
          }
132
        ],
133
        "address": [
134
          {
135
            "line": [
136
              "4762 Hickory Street"
137
            ],
138
            "city": "Monroe",
139
            "district": "Greene",
140
            "state": "WI",
141
            "postalCode": "53566",
142
            "country": "US",
143
            "use": "home"
144
          }
145
        ],
146
        "maritalStatus": {
147
          "coding": [
148
            {
149
              "code": "M",
150
              "system": "http://hl7.org/fhir/v3/MaritalStatus",
151
              "display": "Married"
152
            }
153
          ],
154
          "text": "Married"
155
        },
156
        "communication": [
157
          {
158
            "language": {
159
              "coding": [
160
                {
161
                  "code": "en",
162
                  "system": "urn:ietf:bcp:47"
163
                }
164
              ],
165
              "text": "English"
166
            }
167
          }
168
        ],
169
        "contact": [
170
          {
171
            "name": {
172
              "given": [
173
                "Barbara"
174
              ],
175
              "family": "Bixby"
176
            },
177
            "telecom": [
178
              {
179
                "value": "+18088675303",
180
                "system": "phone",
181
                "use": "home"
182
              },
183
              {
184
                "value": "barbara.bixby@redoxengine.com",
185
                "system": "email"
186
              }
187
            ],
188
            "address": {
189
              "line": [
190
                "4762 Hickory St."
191
              ],
192
              "city": "Monroe",
193
              "district": "Green",
194
              "state": "WI",
195
              "postalCode": "53566",
196
              "country": "USA"
197
            },
198
            "relationship": [
199
              {
200
                "coding": [
201
                  {
202
                    "code": "MTH",
203
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
204
                    "display": "mother"
205
                  }
206
                ],
207
                "text": "Mother"
208
              },
209
              {
210
                "coding": [
211
                  {
212
                    "code": "C",
213
                    "system": "http://terminology.hl7.org/CodeSystem/v2-0131",
214
                    "display": "Emergency Contact"
215
                  }
216
                ],
217
                "text": "Emergency Contact"
218
              }
219
            ]
220
          }
221
        ],
222
        "generalPractitioner": [
223
          {
224
            "reference": "urn:uuid:9ba640d5-ffe9-5aef-ba39-8a0eb67ed150"
225
          }
226
        ],
227
        "managingOrganization": {
228
          "reference": "urn:uuid:9fb9d509-c522-512f-8995-268fed42203f"
229
        }
230
      }
231
    },
232
    {
233
      "fullUrl": "urn:uuid:d4a266b1-6a00-56eb-92ae-eb71235357f0",
234
      "resource": {
235
        "resourceType": "ServiceRequest",
236
        "id": "d4a266b1-6a00-56eb-92ae-eb71235357f0",
237
        "identifier": [
238
          {
239
            "system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
240
            "value": "6547891230"
241
          }
242
        ],
243
        "intent": "order",
244
        "priority": "stat",
245
        "status": "active",
246
        "code": {
247
          "coding": [
248
            {
249
              "code": "49086-2",
250
              "system": "http://loinc.org",
251
              "display": "First trimester maternal screen with nuchal translucency panel"
252
            }
253
          ]
254
        },
255
        "authoredOn": "2022-08-08T08:00:00.000Z",
256
        "note": [
257
          {
258
            "text": "Additional information"
259
          }
260
        ],
261
        "reasonReference": [
262
          {
263
            "reference": "DocumentReference/RedoxDocumentReferenceExampleMediaTimothy"
264
          }
265
        ],
266
        "supportingInfo": [
267
          {
268
            "reference": "Observation/RedoxPlateletObservationExample"
269
          }
270
        ],
271
        "subject": {
272
          "reference": "urn:uuid:627827ad-21bc-56c8-ab24-4218486ea588"
273
        },
274
        "requester": {
275
          "reference": "urn:uuid:9ba640d5-ffe9-5aef-ba39-8a0eb67ed150"
276
        },
277
        "performer": [
278
          {
279
            "reference": "Practitioner/RedoxPractitionerExampleJoan"
280
          }
281
        ],
282
        "specimen": [
283
          {
284
            "reference": "Specimen/RedoxSpecimenExample"
285
          }
286
        ],
287
        "encounter": {
288
          "reference": "Encounter/RedoxEncounterExample"
289
        }
290
      }
291
    },
292
    {
293
      "fullUrl": "urn:uuid:9ba640d5-ffe9-5aef-ba39-8a0eb67ed150",
294
      "resource": {
295
        "resourceType": "Practitioner",
296
        "id": "9ba640d5-ffe9-5aef-ba39-8a0eb67ed150",
297
        "identifier": [
298
          {
299
            "system": "http://hl7.org/fhir/sid/us-npi",
300
            "value": "4356789876"
301
          }
302
        ],
303
        "name": [
304
          {
305
            "given": [
306
              "Pat"
307
            ],
308
            "family": "Granite"
309
          }
310
        ],
311
        "address": [
312
          {
313
            "line": [
314
              "123 Main St."
315
            ],
316
            "city": "Madison",
317
            "district": "Dane",
318
            "state": "WI",
319
            "postalCode": "53703",
320
            "country": "USA"
321
          }
322
        ],
323
        "telecom": [
324
          {
325
            "value": "+16085551234"
326
          }
327
        ]
328
      }
329
    },
330
    {
331
      "fullUrl": "urn:uuid:9fb9d509-c522-512f-8995-268fed42203f",
332
      "resource": {
333
        "resourceType": "Organization",
334
        "id": "9fb9d509-c522-512f-8995-268fed42203f",
335
        "identifier": [
336
          {
337
            "value": "1234",
338
            "system": "urn:oid:1.2.3.4"
339
          }
340
        ],
341
        "active": true,
342
        "name": "Custodial Org",
343
        "address": [
344
          {
345
            "line": [
346
              "123 Main St"
347
            ],
348
            "city": "Madison",
349
            "state": "WI"
350
          }
351
        ],
352
        "telecom": [
353
          {
354
            "value": "1-800-123-4567",
355
            "system": "phone"
356
          }
357
        ],
358
        "type": [
359
          {
360
            "text": "Test Type"
361
          }
362
        ]
363
      }
364
    },
365
    {
366
      "fullUrl": "urn:uuid:af89118c-b587-56c3-8b40-71cf2d5eb0e2",
367
      "resource": {
368
        "resourceType": "Location",
369
        "id": "af89118c-b587-56c3-8b40-71cf2d5eb0e2",
370
        "name": "RHS Vista Oaks Clinic",
371
        "type": [
372
          {
373
            "coding": [
374
              {
375
                "code": "OF",
376
                "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
377
                "display": "Outpatient Facility"
378
              }
379
            ]
380
          }
381
        ],
382
        "physicalType": {
383
          "coding": [
384
            {
385
              "code": "bu",
386
              "system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
387
              "display": "Building"
388
            }
389
          ]
390
        }
391
      }
392
    }
393
  ],
394
  "timestamp": "2025-09-29T12:20:00.000Z"
395
}'

Request Body Schema

    Bundle sent as part of a referral-schedule-update message

  • resourceType
    required, string

    Identifies the type of the resource

    Value: Bundle
  • type
    required, string

    Identifies this bundle as a message

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

    An entry in the bundle containing a FHIR resource

    • resource
      required, object

      Additional metadata about the message including the event

      • resourceType
        required, string

        Identifies the type of the resource

        Value: MessageHeader
      • source
        required, object

        Information about the sender of the message and the Bundle content.

        • endpoint
          required, string

          Identifies the routing target to send acknowledgements to.

        • name
          string

          Human-readable name for the source system.

      • focus
        required, Array of object

        This describes the focal target resource of the message from which the remainder of the content is referenced from

        Must be a resource of type Appointment.

        • 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.

      • eventUri
        required, string

        This describes the message being communicated

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

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

Response fields and example

This response has no body.

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.