Mns 2330 add imms event

package.json

@@ -15,7 +15,7 @@
     "postman-runtime": "^7.52.0"
   },
   "devDependencies": {
-    "@redocly/cli": "^2.20.3",
+    "@redocly/cli": "^2.20.4",
     "license-checker": "^25.0.1"
   },
   "overrides": {

pyproject.toml

@@ -20,7 +20,7 @@ pytest-nhsd-apim = "^6.0.7"
 
 [tool.poetry.group.dev.dependencies]
 flake8 = "^7.3.0"
-black = "^25.1"
+black = "^26.3"
 jinja2 = "^3.1.6"
 pyyaml = "^6.0"
 semver = "^3.0.2"

signal-schemas/examples/imms-vaccination-record-change-1/signal.json

@@ -0,0 +1,83 @@
+{
+  "resourceType": "Bundle",
+  "id": "e0b3d12f-c64d-4b29-b23b-4a670941f572",
+  "type": "history",
+  "timestamp": "2026-03-04T16:45:49.054765+00:00",
+  "entry": [
+    {
+      "fullUrl": "urn:uuid:ea8ab860-1005-4f6a-a090-3e596f5af323",
+      "resource": {
+        "resourceType": "Parameters",
+        "meta": {
+          "profile": [
+            "http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-subscription-status-r4"
+          ]
+        },
+        "id": "ea8ab860-1005-4f6a-a090-3e596f5af323",
+        "parameter": [
+          {
+            "name": "subscription",
+            "valueReference": {
+              "reference": "https://api.service.nhs.uk/multicast-notification-service/subscriptions"
+            }
+          },
+          {
+            "name": "status",
+            "valueCode": "active"
+          },
+          {
+            "name": "type",
+            "valueCode": "event-notification"
+          },
+          {
+            "name": "notification-event",
+            "part": [
+              {
+                "name": "event-number",
+                "valueString": "1"
+              },
+              {
+                "name": "timestamp",
+                "valueInstant": "2026-03-04T16:45:49.054765+00:00"
+              },
+              {
+                "name": "focus",
+                "valueReference": {
+                  "reference": "https://int.api.service.nhs.uk/immunisation-fhir-api/FHIR/R4/Immunization/29dc4e84-7e72-11ee-b962-0242ac120002"
+                }
+              }
+            ]
+          },
+          {
+            "name": "additional-context",
+            "part": [
+              {
+                "name": "event-type",
+                "valueString": "imms-vaccination-record-change-1"
+              },
+              {
+                "name": "source",
+                "valueUri": "uk.nhs.vaccinations-data-flow-management"
+              },
+              {
+                "name": "subject",
+                "valueReference": {
+                  "identifier": {
+                    "value": "9912003888"
+                  }
+                }
+              }
+            ]
+          }
+        ]
+      },
+      "request": {
+        "method": "GET",
+        "url": "https://api.service.nhs.uk/multicast-notification-service/subscriptions"
+      },
+      "response": {
+        "status": "200"
+      }
+    }
+  ]
+}

specification/multicast-notification-service.yaml

@@ -195,6 +195,23 @@ paths:
             schema:
               $ref: "#/components/schemas/cloudevent"
             examples:
+              imms-vaccination-record-change-1:
+                description: "Create an immunisation vaccination record change event"
+                value:
+                  specversion: '1.0'
+                  id: e0b3d12f-c64d-4b29-b23b-4a670941f572
+                  source: uk.nhs.vaccinations-data-flow-management
+                  type: imms-vaccination-record-change-1
+                  time: '2020-06-01T13:00:00Z'
+                  dataref: https://api.service.nhs.uk/immunisation-fhir-api/FHIR/R4/Immunization/29dc4e84-7e72-11ee-b962-0242ac120002
+                  subject: '9912003888'
+                  filtering:
+                    generalpractitioner: 'FY4563'
+                    sourceorganisation: 'FT6786'
+                    sourceapplication: 'RAVS'
+                    subjectage: 17
+                    immunisationtype: 'HPV'
+                    action: 'CREATE'
               nhshco-hc-complete-1:
                 description: "Create a health check complete event"
                 value:

specification/requestBody/create-or-update-subscription-body.yaml

@@ -86,6 +86,18 @@ content:
                 custom_header_1: "custom_value_1"
                 custom_header_2: "custom_value_2"
     examples:
+          immsVaccinationRecordChangeSubscription:
+            description: "Immunisation vaccination record change subscription"
+            value:
+              resourceType: "Subscription"
+              status: "requested"
+              end: "2022-04-05T17:31:00.000Z"
+              reason: "Business process A"
+              criteria: "eventType=imms-vaccination-record-change-1"
+              channel:
+                type: "message"
+                endpoint: "arn:aws:sqs:eu-west-2:123456789012:queue1"
+                payload: "application/fhir+json"
           healthCheckCompleteSubscription:
             description: "Health check complete subscription"
             value: