---
title: "GET /v0/notifications"
method: GET
path: "/v0/notifications"
tags: ["Notifications API"]
---

# GET /v0/notifications

`GET /v0/notifications`

Receive notifications API - Get any unacknowledged notifications

## Query parameters

- `created_before` string, date-time
- `created_after` string, date-time
- `status` 'NEW' | 'ACKNOWLEDGED'
- `occurred_before` string, date-time
- `occurred_after` string, date-time
- `notification_type` string
- `subject` string
- `additional_provider_filter` string
- `limit` integer

## Response `200`

List of notifications

- object
  - `data` NotificationResponse[]
    - `notification_id` string, uuid — The unique identifier of the notification
    - `created_datetime` string, date-time — Date and time the notification was created
    - `event_datetime` string, date-time — Date and time the event occurred
    - `payload_schema` string, uri — A link to a resource that describes the schema of the payload, this could be a JSON schema or documentation for example
    - `notification_type` string — The type of notification, required to distiguish notification types that share a schema
    - `subject_type` string — An indicator for the type of the subject
    - `subject` string — Unique reference to the subject of the notification
    - `additional_provider_filter` string — Provides additional filtering for larger integrators
    - `status` 'NEW' | 'ACKNOWLEDGED'
    - `payload` object — The payload of the notification

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Server Error

---

[API](https://skmtc.net/hm-land-registry/apis/v0-3-submit-an-application-to-change-the-land-register-api-s.md) · [All operations](https://skmtc.net/hm-land-registry/apis/v0-3-submit-an-application-to-change-the-land-register-api-s/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hm-land-registry/v0-3-submit-an-application-to-change-the-land-register-api-s/revisions/66ddff5586eb/schema)