Summary Parameter
The client can request the server to return only a portion of the resources
by using the parameter _summary
.
GET [base]/Patient?_summary=true
The _summary
parameter requests the server to return a subset of the
resource. It can contain one of the following values:
Table 11-5 Summary Parameter Values
Value | Description |
---|---|
true | Return a limited subset of elements from the resource. |
text | Return only the text, id, meta, and top-level
mandatory elements.
|
data | Remove the text element.
|
count | Search only: just return a count of the matching resources, without returning the actual matches. |
false | Return all parts of the resource(s). |
Sample Response of _summary=true
GET [base]/Patient?_summary=true
{
"resourceType": "Bundle",
"id": "71702ee9-4046-49c0-9840-0fe139a2afd1",
"meta": {
"lastUpdated": "2024-02-26T08:34:47.477+00:00",
"tag": [ {
"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
"code": "SUBSETTED",
"display": "Resource encoded in summary mode"
} ]
},
"type": "searchset",
"total": 1,
"link": [ {
"relation": "self",
"url": "http://hsgbu-lon-166.snlhrprshared1.gbucdsint02lhr.oraclevcn.com:3003/oracle-fhir-server/fhir/Patient?_summary=true"
} ],
"entry": [ {
"fullUrl": "http://hsgbu-lon-166.snlhrprshared1.gbucdsint02lhr.oraclevcn.com:3003/oracle-fhir-server/fhir/Patient/1",
"resource": {
"resourceType": "Patient",
"id": "1",
"meta": {
"versionId": "1",
"lastUpdated": "2024-02-26T06:59:39.364+00:00",
"source": "#rIx8lDj54KOhTZF0",
"tag": [ {
"system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
"code": "SUBSETTED",
"display": "Resource encoded in summary mode"
} ]
},
"identifier": [ {
"use": "usual",
"type": {
"coding": [ {
"system": "http://terminology.hl7.org/CodeSystem/v2-0203",
"code": "MR"
} ]
},
"system": "urn:oid:1.2.36.146.595.217.0.1",
"value": "12345",
"period": {
"start": "2001-05-06"
},
"assigner": {
"display": "Acme Healthcare"
}
} ],
"active": true,
"name": [ {
"use": "official",
"family": "Chalmers",
"given": [ "Peter", "James" ]
}, {
"use": "usual",
"given": [ "Jim" ]
}, {
"use": "maiden",
"family": "Windsor",
"given": [ "Peter", "James" ],
"period": {
"end": "2002"
}
} ],
"telecom": [ {
"use": "home"
}, {
"system": "phone",
"value": "(03) 5555 6473",
"use": "work",
"rank": 1
}, {
"system": "phone",
"value": "(03) 3410 5613",
"use": "mobile",
"rank": 2
}, {
"system": "phone",
"value": "(03) 5555 8834",
"use": "old",
"period": {
"end": "2014"
}
} ],
"gender": "male",
"birthDate": "1974-12-25",
"deceasedBoolean": false,
"address": [ {
"use": "home",
"type": "both",
"text": "534 Erewhon St PeasantVille, Rainbow, Vic 3999",
"line": [ "534 Erewhon St" ],
"city": "PleasantVille",
"district": "Rainbow",
"state": "Vic",
"postalCode": "3999",
"period": {
"start": "1974-12-25"
}
} ]
},
"search": {
"mode": "match"
}
} ]
}
Parent topic: Modify Search Results