Convert - Combine FHIR Bundles (R4)

POST /convert/v1/combinefhirr4bundles/:personID

This operation aggregates information retrieved from prior Convert API requests into a single entry.

See the Convert API Overview for general principles that apply to all Convert API operations.

Inputs and Outputs

The input is a newline-delimited JSON list of FHIR R4 Bundles, with each entry a bundle retrieved from the conversion operations.

The output is a single FHIR R4 Bundle containing the merged data from the input. OperationOutcomes from the input bundles are not carried forward. The combined bundle will contain a new OperationOutcome resource detailing the results (including warnings or errors) of the conversion process.

Person ID

The input bundles will each have their own Patient resources with disparate id fields. In the resulting output bundle, these resources will be merged into a single Patient resource, with the personID from the URL segment used for the id field. Although Rosetta will generate a default person ID if none is provided, it is strongly recommended that you provide your own person ID.

Example

Try It
Try out the operations, with examples, in the Rosetta Sandbox.
Sample Input
{"resourceType":"Bundle","type":"searchset","entry":[...]}
{"resourceType":"Bundle","type":"searchset","entry":[...]}

FHIR Bundles are verbose, so the output below just shows a small sample to illustrate how the data is structured. For a more complete example, try out the API in one of the Quickstart Tools, or refer to the FHIR Specification.

Sample Output
{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "resource": {
        "resourceType": "Patient",
        ... (patient fields)
      }
    },
    {
      "resource": {
        "resourceType": "Encounter",
        ... (encounter fields)
      }
    },
    ...
    {
      "resource": {
        "resourceType": "OperationOutcome",
        "issue": [
          ... (any processing issues)
      }
    }
  ]
}