R4 Draft for Comment

This page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4

2.6.3 ND-JSON Representation of Resources

Implementable Technology Specifications Work GroupMaturity Level: 5Ballot Status: Normative

Normative Candidate Note: This page is candidate normative content for R4 in the Infrastructure Package. Once normative, it will lose it's Maturity Level, and breaking changes will no longer be made.

ns-json (New line delimited JSON) is a variant of the JSON format that is supported for bulk data transfer. In principle, nd-json is a simple variation on the JSON format, but where resources are serialised with no whitespace, and separated by a newline pair (characters 13 and 10). 

{
  { "resourceType" : "[type]", .... }
  { "resourceType" : "[type]", .... }
}

The MIME-type for this format is application/x-ndjson (or is it application/fhir+ndjson?)

In order to simplify nd-json processing, each nd-json document contains only resources of a single type - every line contains a resource of a particular type. (though note that resources may still contain contained resources of various types).

On the RESTful API, the nd-json format can only be retrieved using the Asynchronous Pattern.