NHSDigital · ChristopherBacon · Jan 13, 2026 · Dec 19, 2025 · Dec 22, 2025 · Dec 22, 2025
diff --git a/postman/validated_relationship_service.integration.postman_collection.json b/postman/validated_relationship_service.integration.postman_collection.json
diff --git a/postman/validated_relationship_service.sandbox.postman_collection.json b/postman/validated_relationship_service.sandbox.postman_collection.json
diff --git a/specification/examples/requests/PATCH_Consent/replace_legal_basis.yaml b/specification/examples/requests/PATCH_Consent/replace_legal_basis.yaml
@@ -1,17 +1,17 @@
 ReplaceLegalBasisRequest:
   summary: Replace legal basis
-  description: payload used to replace the legal basis of a consent resource
+  description: payload used to add a new actor (legal basis) to the consent provision
   value:
     - op: replace
       path: /provision/actor
       value:
-        - role:
-            coding:
-              - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-                code: court-appointed-personal-welfare-deputy
-                display: Court appointed personal welfare deputy
-          reference:
-            type: RelatedPerson
-            identifier:
-              system: https://fhir.nhs.uk/Id/nhs-number
-              value: "9000000017"
+        role:
+          coding:
+            - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+              code: court-appointed-personal-welfare-deputy
+              display: Court appointed personal welfare deputy
+        reference:
+          type: RelatedPerson
+          identifier:
+            system: https://fhir.nhs.uk/Id/nhs-number
+            value: "9000000017"
diff --git a/specification/examples/requests/PATCH_Consent/replace_provision_end_date.yaml b/specification/examples/requests/PATCH_Consent/replace_provision_end_date.yaml
@@ -0,0 +1,9 @@
+UpdateProvisionEndDate:
+      summary: Set provision end date
+      description: >
+        Example apply end date to a relationship.
+        The relationship will be considered as ended following this date.
+      value:
+        - op: add
+          path: /provision/period/end
+          value: "2026-12-31T23:59:59Z"
diff --git a/specification/examples/requests/PATCH_Consent/replace_status.yaml b/specification/examples/requests/PATCH_Consent/replace_status.yaml
@@ -5,8 +5,8 @@ StatusUpdate:
     - op: replace
       path: /status
       value: inactive
-    - op: replace
-      path: /extension
+    - op: add
+      path: /extension/-
       value:
       - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
         valueCodeableConcept:

diff --git a/specification/examples/requests/POST_Consent/adult_to_adult_proxy_creation.yaml b/specification/examples/requests/POST_Consent/adult_to_adult_proxy_creation.yaml
@@ -27,23 +27,23 @@ ConsentAdultToAdultGuardianRequest:
           system: https://fhir.nhs.uk/Id/nhs-number
           value: "9000000017"
     provision:
-      period:
-        start: "2025-02-11"
-      actor:
-        - role:
-            coding:
-              - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-                code: court-appointed-personal-welfare-deputy
-                display: Court appointed personal welfare deputy
-          reference:
-            type: RelatedPerson
-            identifier:
-              system: https://fhir.nhs.uk/Id/nhs-number
-              value: "9000000017"
+      - period:
+          start: "2025-02-11T14:30:00Z"
+        actor:
+          - role:
+              coding:
+                - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  code: court-appointed-personal-welfare-deputy
+                  display: Court appointed personal welfare deputy
+            reference:
+              type: RelatedPerson
+              identifier:
+                system: https://fhir.nhs.uk/Id/nhs-number
+                value: "9000000017"
     extension:
       - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
         valueCodeableConcept:
           coding:
             - system: https://terminology.hl7.org/CodeSystem/consent-reason
               code: ROLE_CREATED
-              display: Role created from scratch by GP
+              display: Role created from scratch by GP
diff --git a/specification/examples/requests/POST_Consent/parent_child_proxy_creation.yaml b/specification/examples/requests/POST_Consent/parent_child_proxy_creation.yaml
@@ -27,24 +27,24 @@ ConsentParentChildProxyCreationRequest:
           system: https://fhir.nhs.uk/Id/nhs-number
           value: "9000000009"
     provision:
-      period:
-        start: "2025-02-11"
-        end: "2026-02-11"
-      actor:
-        - role:
-            coding:
-              - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-                code: parental-responsibility
-                display: Parental responsibility
-          reference:
-            type: RelatedPerson
-            identifier:
-              system: https://fhir.nhs.uk/Id/nhs-number
-              value: "9000000009"
+      - period:
+          start: "2025-02-11T14:30:00Z"
+          end: "2026-02-11T14:30:00Z"
+        actor:
+          - role:
+              coding:
+                - system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  code: parental-responsibility
+                  display: Parental responsibility
+            reference:
+              type: RelatedPerson
+              identifier:
+                system: https://fhir.nhs.uk/Id/nhs-number
+                value: "9000000009"
     extension:
       - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
         valueCodeableConcept:
           coding:
             - system: https://terminology.hl7.org/CodeSystem/consent-reason
               code: ROLE_CREATED
-              display: Role created from scratch by GP
+              display: Role created from scratch by GP
diff --git a/.../examples/responses/GET_Consent/filtered-relationships-status-active-include-details.yaml b/.../examples/responses/GET_Consent/filtered-relationships-status-active-include-details.yaml
@@ -103,13 +103,13 @@ ConsentMultipleRelationshipsStatusActiveIncludeDetailsBundle:
             actor:
             - reference:
                 identifier:
-                  system: https://fhir.nhs.uk/Id/nhs-number
+                  system: "https://fhir.nhs.uk/Id/nhs-number"
                   value: "9000000017"
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: "Parental responsibility"
+                    system: "https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis"
             period:
               end: "2026-02-11"
               start: "2025-02-11"

diff --git a/...ication/examples/responses/GET_Consent/filtered-relationships-status-proposed-active.yaml b/...ication/examples/responses/GET_Consent/filtered-relationships-status-proposed-active.yaml
@@ -47,9 +47,9 @@ ConsentMultipleRelationshipsStatusProposedActiveBundle:
                   value: '9000000017'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: '2026-02-11'
               start: '2025-02-11'
@@ -100,9 +100,9 @@ ConsentMultipleRelationshipsStatusProposedActiveBundle:
                   value: '9000000017'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: '2026-02-11'
               start: '2025-02-11'
@@ -153,9 +153,9 @@ ConsentMultipleRelationshipsStatusProposedActiveBundle:
                   value: '9000000017'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: '2026-02-11'
               start: '2025-02-11'
@@ -206,9 +206,9 @@ ConsentMultipleRelationshipsStatusProposedActiveBundle:
                   value: '9000000017'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: '2026-02-11'
               start: '2025-02-11'

diff --git a/specification/examples/responses/GET_Consent/multiple-relationships-include-patient.yaml b/specification/examples/responses/GET_Consent/multiple-relationships-include-patient.yaml
@@ -81,9 +81,9 @@ ConsentMultipleRelationshipsIncludePatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"
@@ -164,9 +164,9 @@ ConsentMultipleRelationshipsIncludePatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"
@@ -231,7 +231,7 @@ ConsentMultipleRelationshipsIncludePatientBundle:
             identifier:
               system: "https://fhir.nhs.uk/Id/nhs-number"
               value: "9000000006"
-          dateTime: "2024-07-21T17:32:28Z"
+          dateTime: "2024-07-21T1T32:28Z"
           performer:
             - identifier:
                 system: "https://fhir.nhs.uk/Id/nhs-number"
@@ -247,9 +247,9 @@ ConsentMultipleRelationshipsIncludePatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"

diff --git a/...tion/examples/responses/GET_Consent/multiple-relationships-include-performer-patient.yaml b/...tion/examples/responses/GET_Consent/multiple-relationships-include-performer-patient.yaml
@@ -107,9 +107,9 @@ ConsentMultipleRelationshipsIncludePerformerPatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: parental-responsibility
-                  display: Parental responsibility
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: parental-responsibility
+                    display: Parental responsibility
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"
@@ -211,9 +211,9 @@ ConsentMultipleRelationshipsIncludePerformerPatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: best-interest
-                  display: Best Interest
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: best-interest
+                    display: Best Interest
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"
@@ -315,9 +315,9 @@ ConsentMultipleRelationshipsIncludePerformerPatientBundle:
                   value: '9000000022'
               role:
                 coding:
-                - code: best-interest
-                  display: Best Interest
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+                  - code: best-interest
+                    display: Best Interest
+                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
             period:
               end: "2026-02-11"
               start: "2025-02-11"

diff --git a/specification/examples/responses/GET_Consent/multiple-relationships-include-performer.yaml b/specification/examples/responses/GET_Consent/multiple-relationships-include-performer.yaml
@@ -67,19 +67,19 @@ ConsentMultipleRelationshipsIncludePerformerBundle:
             - authority: https://www.england.nhs.uk
               uri: REPLACE_WITH_LINK_TO_PUBLISHED_NATIONAL_PROXY_STANDARD
           provision:
-            actor:
-            - reference:
-                identifier:
-                  system: https://fhir.nhs.uk/Id/nhs-number
-                  value: '9000000022'
-              role:
-                coding:
-                  - code: parental-responsibility
-                    display: Parental responsibility
-                    system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-            period:
-              end: '2026-02-11'
-              start: '2025-02-11'
+              actor:
+                - reference:
+                    identifier:
+                      system: https://fhir.nhs.uk/Id/nhs-number
+                      value: '9000000022'
+                  role:
+                    coding:
+                      - code: parental-responsibility
+                        display: Parental responsibility
+                        system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+              period:
+                end: '2026-02-11'
+                start: '2025-02-11'
           extension:
           - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
             valueCodeableConcept:
@@ -142,19 +142,19 @@ ConsentMultipleRelationshipsIncludePerformerBundle:
             - authority: https://www.england.nhs.uk
               uri: REPLACE_WITH_LINK_TO_PUBLISHED_NATIONAL_PROXY_STANDARD
           provision:
-            actor:
-            - reference:
-                identifier:
-                  system: https://fhir.nhs.uk/Id/nhs-number
-                  value: '9000000022'
-              role:
-                coding:
-                - code: best-interest
-                  display: Best Interest
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-            period:
-              end: '2026-02-11'
-              start: '2025-02-11'
+              actor:
+                - reference:
+                    identifier:
+                      system: https://fhir.nhs.uk/Id/nhs-number
+                      value: '9000000022'
+                  role:
+                    coding:
+                      - code: best-interest
+                        display: Best Interest
+                        system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+              period:
+                end: '2026-02-11'
+                start: '2025-02-11'
           extension:
           - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
             valueCodeableConcept:
@@ -217,19 +217,19 @@ ConsentMultipleRelationshipsIncludePerformerBundle:
             - authority: https://www.england.nhs.uk
               uri: REPLACE_WITH_LINK_TO_PUBLISHED_NATIONAL_PROXY_STANDARD
           provision:
-            actor:
-            - reference:
-                identifier:
-                  system: https://fhir.nhs.uk/Id/nhs-number
-                  value: '9000000022'
-              role:
-                coding:
-                - code: best-interest
-                  display: Best Interest
-                  system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
-            period:
-              end: '2026-02-11'
-              start: '2025-02-11'
+              actor:
+                - reference:
+                    identifier:
+                      system: https://fhir.nhs.uk/Id/nhs-number
+                      value: '9000000022'
+                  role:
+                    coding:
+                      - code: best-interest
+                        display: Best Interest
+                        system: https://fhir.nhs.uk/England/CodeSystem/England-NHSProxyLegalBasis
+              period:
+                end: '2026-02-11'
+                start: '2025-02-11'
           extension:
           - url: https://fhir.hl7.org.uk/StructureDefinition/Extension-statusReason
             valueCodeableConcept: