---
title: "Get patients referrals, bookings, documents, questionnaires and waiting lists"
method: GET
path: "/aggregator/events"
tags: ["Patient Care Aggregator"]
---

# Get patients referrals, bookings, documents, questionnaires and waiting lists

`GET /aggregator/events`

The Wayfinder Patient Care Aggregator CarePlan response will return a FHIR [Bundle](https://www.hl7.org/fhir/r4/bundle.html) resource which will contain one [CarePlan](https://www.hl7.org/fhir/r4/careplan.html) resource per Waiting List Entry, one [CarePlan](https://www.hl7.org/fhir/r4/careplan.html) resource containing all Referrals, Appointments, Documents and Questionnaires and one optional [OperationOutcome](https://www.hl7.org/fhir/r4/OperationOutcome.html) resource (based on the UK Core FHIR specification) for use by the NHS App to the following specification.

## Query parameters

- `patient:identifier` string, required

## Headers

- `X-Correlation-ID` string, uuid, required
- `NHSD-ID-Token` string, byte, required

## Response `2XX`

The request was valid and the API was able to request information from the various upstream applications.

There are two possible outcomes:

| HTTP status | Description                                                         |
| ----------- | ------------------------------------------------------------------- |
| 200         | A successful request will return a HTTP status code of `200 OK` containing a FHIR `Bundle` with `0..*` `CarePlan` resources. All upstream systems responded normally. |
| 207         | If an error occurs with an upstream service the aggregator will return a `207 Multi-status` containing a FHIR `Bundle` with `0..*` `CarePlan` resources and one `OperationOutcome` with each of the errors listed as issues. |

## Other responses

- `4XX` — When the aggregator service is unable to serve a successful response a FHIR `OperationOutcome` resource is returned with the relevant HTTP status code defined as follows: | HTTP status | Error code | Description | | ----------- | ------------------- | ------------------------------------------------------------------- | | 400 | `exception` | Missing or invalid NHS number in request | | 401 | `processing` | Missing or invalid OAuth 2.0 bearer token in request | | 401 | `processing` | NHS number in request doesn't match NHS number in NHS login account | | 403 | `forbidden` | Patient is under 16 years of age | | 404 | `not-found` | Invalid value in `NHSD-Target-Identifier` header | | 429 | `TOO_MANY_REQUESTS` | You have exceeded your application's [rate limit](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#rate-limits). | For details see the `diagnostics` field.
- `5XX` — A 5xx status code means the server has a problem. For more details on the most common 5xx status codes and their meanings see the [HTTP status codes](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#http-status-codes).

---

[API](https://skmtc.dev/nhs/apis/patient-care-aggregator-api.md) · [All operations](https://skmtc.dev/nhs/apis/patient-care-aggregator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhs/patient-care-aggregator-api/revisions/4f98b258073f/schema)