FHIR Resource Versions

The FHIR® resource version history is automatically captured for each resource. The version number is automatically incremented each time a resource is created or changed by a POST request.

To get the version history of a FHIR resource, you must authenticate to the 1up FHIR Server with a specific 1up user ID. You can't specify client for the x-oneup-user-id value.

To retrieve a particular historical version of a FHIR resource, you can make a GET request, similar to the following example.

Patient/{{fhirId}}/_history/9000000000001

In this example, 9000000000001 is the version number.

If you make a request to Patient/{{fhirId}}/_history without specifying the version, the response is a bundle array of all available versions of that particular FHIR resource.