---
title: "Get a list of notifications"
method: GET
path: "/misc/push-pull-notification/box/{boxId}/notifications"
tags: ["push-pull-notification-api"]
---

# Get a list of notifications

`GET /misc/push-pull-notification/box/{boxId}/notifications`

Returns a list of notifications that have been sent to a box. <br><br>A maximum of 100 notifications will be returned. These will be ordered oldest first. <br><br>The OAuth bearer token used by this endpoint must have the scope `read:pull-notifications`.

## Path parameters

- `boxId` string, required

## Query parameters

- `status` string
- `fromDate` string
- `toDate` string
- `count` integer

## Headers

- `Accept` 'application/vnd.hmrc.1.0+json', required

## Response `200`

OK

- object[]
  - `notificationId` string, required — Unique identifier for a notification.
  - `boxId` string, required — Unique identifier for a box the notification was sent to.
  - `messageContentType` 'application/json' | 'application/xml', required — Content type of the message.
  - `message` string, required — The notification message defined by messageContentType (JSON or XML). If this is JSON then it will have been escaped. Details on the structure of this data can be found in the documentation for the HMRC API that created the notification.
  - `status` 'PENDING' | 'FAILED' | 'ACKNOWLEDGED', required — Status of the notification.
  - `createdDateTime` string, required — ISO-8601 UTC date and time the notification was created.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `406` — Not Acceptable

---

[API](https://skmtc.dev/hmrc/apis/push-pull-notifications-api.md) · [All operations](https://skmtc.dev/hmrc/apis/push-pull-notifications-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hmrc/push-pull-notifications-api/revisions/fa3b06e0c42e/schema)