From e074006363f6f6c02f5a8928db2b7e0dd5388bf4 Mon Sep 17 00:00:00 2001
From: simonlabarere <simon.labarere1@nhs.net>
Date: Tue, 3 Mar 2026 13:51:41 +0000
Subject: [PATCH 1/2] CCM-14511: Add PDS Source Change Number to Message Status
 Callback

---
 .../schemas/components/MessageStatus.yaml         |  5 +++++
 specification/schemas/types/Metadata.yaml         | 15 +++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 specification/schemas/types/Metadata.yaml

diff --git a/specification/schemas/components/MessageStatus.yaml b/specification/schemas/components/MessageStatus.yaml
index 9ec05ebe4..10182e932 100644
--- a/specification/schemas/components/MessageStatus.yaml
+++ b/specification/schemas/components/MessageStatus.yaml
@@ -43,6 +43,11 @@ properties:
         example: '2023-11-17T14:27:51.413Z'
       routingPlan:
         $ref: ../types/RoutingPlan.yaml
+      metadata:
+        type: array
+        minItems: 0
+        items:
+          $ref: ../types/Metadata.yaml
     required:
       - messageId
       - messageReference
diff --git a/specification/schemas/types/Metadata.yaml b/specification/schemas/types/Metadata.yaml
new file mode 100644
index 000000000..bdbb4bb8a
--- /dev/null
+++ b/specification/schemas/types/Metadata.yaml
@@ -0,0 +1,15 @@
+type: object
+additionalProperties: false
+properties:
+  version:
+    type: string
+    description: The Source Change Number
+    example: '2'
+  queriedAt:
+    type: date-time
+    description: The timestamp when the source was queried
+    example: '2023-11-17T14:27:51.413Z'
+  source:
+    type: string
+    description: This identifies the source of the metadata. This is a free text field and can be used to identify the system that provided the metadata.
+    example: 'pds'

From 4b3ead38d88c07586a6337752a0bda4a2ed29375 Mon Sep 17 00:00:00 2001
From: simonlabarere <simon.labarere1@nhs.net>
Date: Thu, 5 Mar 2026 13:29:59 +0000
Subject: [PATCH 2/2] CCM-14511: Address review comments

---
 specification/schemas/components/MessageStatus.yaml | 2 +-
 specification/schemas/types/Metadata.yaml           | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/specification/schemas/components/MessageStatus.yaml b/specification/schemas/components/MessageStatus.yaml
index 10182e932..0a89c165a 100644
--- a/specification/schemas/components/MessageStatus.yaml
+++ b/specification/schemas/components/MessageStatus.yaml
@@ -45,7 +45,7 @@ properties:
         $ref: ../types/RoutingPlan.yaml
       metadata:
         type: array
-        minItems: 0
+        minItems: 1
         items:
           $ref: ../types/Metadata.yaml
     required:
diff --git a/specification/schemas/types/Metadata.yaml b/specification/schemas/types/Metadata.yaml
index bdbb4bb8a..3aeb107f0 100644
--- a/specification/schemas/types/Metadata.yaml
+++ b/specification/schemas/types/Metadata.yaml
@@ -3,7 +3,7 @@ additionalProperties: false
 properties:
   version:
     type: string
-    description: The Source Change Number
+    description: The version identifier of the source data at the time it was queried
     example: '2'
   queriedAt:
     type: date-time
@@ -13,3 +13,6 @@ properties:
     type: string
     description: This identifies the source of the metadata. This is a free text field and can be used to identify the system that provided the metadata.
     example: 'pds'
+required:
+  - queriedAt
+  - source