Clinical | Allergy Intolerance

0. References

1. Read

Return a single AllergyIntolerance for the specified id.

All requests MUST contain a valid ‘Authorization’ header and SHOULD contain an ‘Accept’ header. The `Accept` header indicates the format of the response the client is able to understand, this will be one of the following application/fhir+json or application/fhir+xml.

1.1. Response

A full set of response codes can be found here API Response Codes. FHIR Servers MUST support the following response codes:

2. Search

Search for all allergies for a patient. Fetches a bundle of all AllergyIntolerance resources for the specified patient.

All requests MUST contain a valid ‘Authorization’ header and SHOULD contain an ‘Accept’ header. The `Accept` header indicates the format of the response the client is able to understand, this will be one of the following application/fhir+xml or application/fhir+json.

2.1. Search Parameters

The search parameters and combinations that are mandated as a minimum in the API for the AllergyIntolerance resource are detailed below.

Query parameters conformance will be categorised as:

MUST - these search parameters MUST be implemented for the specified resource type.

SHOULD - these search parameters are expected to be implemented, if the data to support the query is present in the host system.

Additional search parameters MAY be added to reflect local requirements.

To be conformant, provider systems are required to implement all of the MUST parameters.

The parameters can be used independently or in combination to help refine the search results returned.

Search parameter combinations for the AllergyIntolerance resource are as follows:

This section outlines the search parameter syntax used, with some examples provided.

2.1.1. clinical-status

See token for details on this parameter.

To filter on clinical-status ( active | inactive | resolved )

GET [baseUrl]/AllergyIntolerance?patient=1&clinical-status=active

Return all AllergyIntolerance resources with a clinical-status of active and Patient with a logical id of 1.

2.1.2. code

See token for details on this parameter. ‘code’ can be used multiple times as a search parameter

system is a uniform resource identifier which defines which CodeSystem the code belongs to. This is optional and if not present all matching codes will be returned regardles of CodeSystems.

To search for AllergyIntolerances with Amoxicillin using SNOMED CT

GET [baseUrl]/AllergyIntolerance?patient=[id]&code=http://snomed.info/sct|372687004

Return all AllergyIntolerance resources with SNOMED CT code of 372687004 and Patient with a logical id of 1.

GET [baseUrl]/AllergyIntolerance?patient=1&code=372687004

Return all AllergyIntolerance resources with code of 372687004 from any CodeSystem and Patient with a logical id of 1.

2.1.3. patient

See reference for details on this parameter. The patient parameter can be used two ways:

This MUST be supported for all endpoint provider systems.

id is the logical id of the patient on the server which can be obtained by a Patient resource query.

GET [baseUrl]/AllergyIntolerance?patient=42

Return all AllergyIntolerance resources for Patient with a logical id of 42

This SHOULD be supported for all endpoint provider systems.

system is a uniform resource identifier which defines which CodeSystem the identifer belongs to. For NHS Number this would be https://fhir.nhs.uk/Id/nhs-number and code would be the NHS Number.

GET [baseUrl]/AllergyIntolerance?patient.identifier=https://fhir.nhs.uk/Id/nhs-number|9876543210

Return all AllergyIntolerance resources for Patients with a NHS Number of 9876543210

2.1.4. verification-status

See token for details on this parameter.

To filter on verification-status ( unconfirmed | confirmed )

GET [baseUrl]/AllergyIntolerance?patient=1&verification-status=unconfirmed

Return all AllergyIntolerance resources with a verification-status of unconfirmed and Patient with a logical id of 1.

2.2. Search Response

If the search fails (cannot be executed, not that there is no matches), the return value is a status code 4xx or 5xx with an OperationOutcome.

If the search succeeds, the return content is a Bundle with type = searchset containing the results of the search as a list of resources in a defined order. The result list can be long, so servers MAY use paging. If they do, they MUST use this Paging method for breaking the list into pages if appropriate. The server MAY also return an OperationOutcome resource with additional information about the search.

A full set of response codes can be found here API Response Codes. FHIR Servers MUST support the following response codes:

3.1 cURL

curl -X GET -H 'Accept: application/fhir+xml' -H 'Authorisation: BEARER [token]' -v 'https://data.developer.nhs.uk/ccri-fhir/STU3/AllergyIntolerance?patient=1'

3.2 Explore the Response

Reference Implementation
XML Patient id search RI viewer
JSON Patient id search RI viewer