NHSDigital · lelliott-hippo · Sep 18, 2025 · Sep 17, 2025
diff --git a/postman/Validated Relationship Service Sandbox.postman_collection.json b/postman/Validated Relationship Service Sandbox.postman_collection.json
@@ -1,11 +1,11 @@
 {
 	"info": {
-		"_postman_id": "66c6bd03-3fda-4ff7-9be9-bace275b60cf",
-		"name": "Validated Relationship Service Sandbox 08/09/25",
+		"_postman_id": "76babb13-02c0-42b3-84ec-d64ebe45e7b8",
+		"name": "Validated Relationship Service Sandbox 17/09/25",
 		"description": "This Postman collection includes example scenarios for each of the Validated Relationship Service (VRS) API endpoints, covering both valid and invalid request scenarios.\n\nThe collection is pointed towards the VRS sandbox environment, which will return a specific example response based on the request sent. All data shown in the requests or responses is test data.\n\nOur sandbox environment only covers the scenarios listed in the Postman collection and is open access. It does not allow you to test authorisation or any scenarios beyond the ones documented.\n\nFull specification is available at [https://digital.nhs.uk/developer/api-catalogue/validated-relationship-service](https://digital.nhs.uk/developer/api-catalogue/validated-relationship-service)",
 		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
 		"_exporter_id": "45653607",
-		"_collection_link": "https://www.postman.com/lukeelliott-8674106/workspace/validated-relationship-service-sandbox-08-11-2025/collection/45653607-66c6bd03-3fda-4ff7-9be9-bace275b60cf?action=share&source=collection_link&creator=45653607"
+		"_collection_link": "https://www.postman.com/lukeelliott-8674106/workspace/validated-relationship-service-sandbox-17-09-2025/collection/45653607-76babb13-02c0-42b3-84ec-d64ebe45e7b8?action=share&source=collection_link&creator=45653607"
 	},
 	"item": [
 		{
@@ -1760,7 +1760,9 @@
 									"        ]",
 									"      },",
 									"      \"diagnostics\": \"Not a valid NHS Number provided for the 'identifier' parameter\",",
-									"      \"expression\": \"RelatedPerson.identifier\",",
+									"      \"expression\": [",
+									"        \"RelatedPerson.identifier\"",
+									"      ],",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -1919,6 +1921,7 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Resource that has been marked as invalid was requested - invalid resources cannot be retrieved\",",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -1939,7 +1942,8 @@
 									"    pm.expect(responseJson).to.eql(expectedResponseBody);",
 									"});"
 								],
-								"type": "text/javascript"
+								"type": "text/javascript",
+								"packages": {}
 							}
 						}
 					],
@@ -1997,6 +2001,7 @@
 									"                    }",
 									"                ]",
 									"            },",
+									"            \"diagnostics\": \"Resource that has been marked as invalid was requested - invalid resources cannot be retrieved\",",
 									"            \"severity\": \"error\"",
 									"        }",
 									"    ],",
@@ -2017,7 +2022,8 @@
 									"    pm.expect(responseJson).to.eql(expectedResponseBody);",
 									"});"
 								],
-								"type": "text/javascript"
+								"type": "text/javascript",
+								"packages": {}
 							}
 						}
 					],
@@ -7296,9 +7302,7 @@
 									"  \"resourceType\": \"OperationOutcome\",",
 									"  \"issue\": [",
 									"    {",
-									"      \"severity\": \"error\",",
 									"      \"code\": \"invalid\",",
-									"      \"diagnostics\": \"Invalid request with error - status parameter is invalid.\",",
 									"      \"details\": {",
 									"        \"coding\": [",
 									"          {",
@@ -7308,7 +7312,9 @@
 									"            \"display\": \"Required parameter(s) are invalid.\"",
 									"          }",
 									"        ]",
-									"      }",
+									"      },",
+									"      \"diagnostics\": \"Invalid request with error - status parameter is invalid.\",",
+									"      \"severity\": \"error\"",
 									"    }",
 									"  ]",
 									"}",
@@ -7375,10 +7381,10 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\",",
 									"      \"severity\": \"error\"",
 									"    }",
-									"  ],",
-									"  \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\"",
+									"  ]",
 									"}",
 									"",
 									"const responseJson = pm.response.json();",
@@ -7435,8 +7441,7 @@
 									"const expectedResponseBody = {",
 									"    \"resourceType\": \"OperationOutcome\",",
 									"    \"issue\": [",
-									"        {",
-									"            \"severity\": \"error\",",
+									"        {  ",
 									"            \"code\": \"processing\",",
 									"            \"details\": {",
 									"                \"coding\": [",
@@ -7447,7 +7452,10 @@
 									"                        \"display\": \"Resource that has been marked as invalid was requested - invalid resources cannot be retrieved\"",
 									"                    }",
 									"                ]",
-									"            }",
+									"            },",
+									"            \"diagnostics\": \"Resource that has been marked as invalid was requested - invalid resources cannot be retrieved\",",
+									"            \"severity\": \"error\",",
+									"            ",
 									"        }",
 									"    ]",
 									"}",
@@ -7466,7 +7474,8 @@
 									"    pm.expect(responseJson).to.eql(expectedResponseBody);",
 									"});"
 								],
-								"type": "text/javascript"
+								"type": "text/javascript",
+								"packages": {}
 							}
 						}
 					],
@@ -7502,7 +7511,6 @@
 									"  \"issue\": [",
 									"    {",
 									"      \"code\": \"invalid\",",
-									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier parameter is invalid.\",",
 									"      \"details\": {",
 									"        \"coding\": [",
 									"          {",
@@ -7513,6 +7521,7 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier parameter is invalid.\",",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -7570,7 +7579,6 @@
 									"  \"issue\": [",
 									"    {",
 									"      \"code\": \"invalid\",",
-									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier system parameter is invalid.\",",
 									"      \"details\": {",
 									"        \"coding\": [",
 									"          {",
@@ -7581,6 +7589,7 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier system parameter is invalid.\",",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -7638,7 +7647,6 @@
 									"  \"issue\": [",
 									"    {",
 									"      \"code\": \"invalid\",",
-									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier parameter not found.\",",
 									"      \"details\": {",
 									"        \"coding\": [",
 									"          {",
@@ -7649,6 +7657,7 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Invalid request with error - performer:identifier or patient:identifier parameter not found.\",",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -7710,6 +7719,7 @@
 									"                    }",
 									"                ]",
 									"            },",
+									"            \"diagnostics\": \"GP Practice could not be found\",",
 									"            \"severity\": \"error\"",
 									"        }",
 									"    ],",
@@ -9414,7 +9424,6 @@
 									"  \"issue\": [",
 									"    {",
 									"      \"code\": \"invalid\",",
-									"      \"diagnostics\": \"Invalid request with error - ID must be a valid UUID.\",",
 									"      \"details\": {",
 									"        \"coding\": [",
 									"          {",
@@ -9425,6 +9434,7 @@
 									"          }",
 									"        ]",
 									"      },",
+									"      \"diagnostics\": \"Invalid request with error - ID must be a valid UUID.\",",
 									"      \"severity\": \"error\"",
 									"    }",
 									"  ],",
@@ -9484,10 +9494,11 @@
 									"                    }",
 									"                ]",
 									"            },",
+									"            \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\",",
 									"            \"severity\": \"error\"",
+									"            ",
 									"        }",
 									"    ],",
-									"    \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\"",
 									"}",
 									"",
 									"const responseJson = pm.response.json();",
@@ -9549,10 +9560,10 @@
 									"                    }",
 									"                ]",
 									"            },",
+									"            \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\",",
 									"            \"severity\": \"error\"",
 									"        }",
 									"    ],",
-									"    \"diagnostics\": \"Invalid request with error - _include parameter is invalid.\"",
 									"}",
 									"",
 									"const responseJson = pm.response.json();",
@@ -9613,6 +9624,7 @@
 									"                    }",
 									"                ]",
 									"            },",
+									"            \"diagnostics\": \"Resource that has been marked as invalid was requested - invalid resources cannot be retrieved\",",
 									"            \"severity\": \"error\"",
 									"        }",
 									"    ],",
@@ -10264,8 +10276,7 @@
 	"variable": [
 		{
 			"key": "api_base_url",
-			"value": "https://sandbox.api.service.nhs.uk/validated-relationships/FHIR/R4",
-			"type": "string"
+			"value": "https://sandbox.api.service.nhs.uk/validated-relationships/FHIR/R4"
 		}
 	]
 }
diff --git a/proxies/live/apiproxy/policies/RaiseFault.404NotFound.xml b/proxies/live/apiproxy/policies/RaiseFault.404NotFound.xml
@@ -32,6 +32,7 @@
                     }
                 ]
             },
+            "diagnostics": "Resource that has been marked as invalid was requested - invalid resources cannot be retrieved",
             "severity": "error"
         }
     ],

diff --git a/specification/examples/responses/GET_Consent/ID/errors/invalid-id.yaml b/specification/examples/responses/GET_Consent/ID/errors/invalid-id.yaml
@@ -4,12 +4,12 @@ ConsentInvalidIDError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Invalid request with error - ID must be a valid UUID."
         details:
           coding:
             - code: "INVALID_ID_VALUE"
               display: "Required parameter(s) are invalid."
               system: "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: "1"
+        diagnostics: "Invalid request with error - ID must be a valid UUID."
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_Consent/errors/gp-practice-not-found.yaml b/specification/examples/responses/GET_Consent/errors/gp-practice-not-found.yaml
@@ -10,5 +10,6 @@ GPPracticeNotFoundError:
               version: "1"
               code: "GP_PRACTICE_NOT_FOUND"
               display: "GP Practice could not be found - invalid resources cannot be retrieved"
+        diagnostics: "GP Practice could not be found"
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_Consent/errors/invalid-identifier-system.yaml b/specification/examples/responses/GET_Consent/errors/invalid-identifier-system.yaml
@@ -4,12 +4,12 @@ ConsentInvalidIdentifierSystemError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Invalid request with error - performer:identifier or patient:identifier system parameter is invalid."
         details:
           coding:
             - code: "INVALID_IDENTIFIER_SYSTEM"
               display: "Required parameter(s) are invalid."
               system: "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: '1'
+        diagnostics: "Invalid request with error - performer:identifier or patient:identifier system parameter is invalid."
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_Consent/errors/invalid-identifier.yaml b/specification/examples/responses/GET_Consent/errors/invalid-identifier.yaml
@@ -4,13 +4,13 @@ ConsentInvalidIdentifierError:
   value:
     issue:
       - code: invalid
-        diagnostics: 'Invalid request with error - performer:identifier or patient:identifier parameter is invalid.'
         details:
           coding:
             - code: "INVALID_IDENTIFIER_VALUE"
               display: "Required parameter(s) are invalid."
               system: "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: '1'
+        diagnostics: 'Invalid request with error - performer:identifier or patient:identifier parameter is invalid.'
         severity: error
     resourceType: "OperationOutcome"
 
diff --git a/specification/examples/responses/GET_Consent/errors/invalid-status-parameter.yaml b/specification/examples/responses/GET_Consent/errors/invalid-status-parameter.yaml
@@ -4,12 +4,12 @@ ConsentInvalidStatusParameterError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Invalid request with error - status parameter is invalid."
         details:
           coding:
             - code: "INVALID_PARAMETER"
               display: "Required parameter(s) are invalid."
               system: "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: "1"
+        diagnostics: "Invalid request with error - status parameter is invalid."
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_Consent/errors/missing-identifier.yaml b/specification/examples/responses/GET_Consent/errors/missing-identifier.yaml
@@ -4,12 +4,12 @@ ConsentIdentifierMissingError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Invalid request with error - performer:identifier or patient:identifier parameter not found."
         details:
           coding:
             - code: "MISSING_IDENTIFIER_VALUE"
               display: "Required parameter(s) are missing."
               system: "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: "1"
+        diagnostics: "Invalid request with error - performer:identifier or patient:identifier parameter not found."
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier-patient.yaml b/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier-patient.yaml
@@ -4,12 +4,12 @@ InvalidIdentifierPatientError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Not a valid NHS Number provided for the 'patient:identifier' parameter"
         details:
           coding:
             - "system": "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: "1"
               code: "INVALID_PATIENT_IDENTIFIER_VALUE"
               display: "Provided value is invalid"
+        diagnostics: "Not a valid NHS Number provided for the 'patient:identifier' parameter"
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier-system.yaml b/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier-system.yaml
@@ -4,12 +4,12 @@ RelatedPersonInvalidIdentifierSystem:
   value:
     issue:
       - code: invalid
-        diagnostics: The identifier system is not valid.
-        severity: error
         details:
           coding:
             - code: INVALID_IDENTIFIER_SYSTEM
               display: Invalid identifier system.
               system: https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode
               version: '1'
+        diagnostics: The identifier system is not valid.
+        severity: error
     resourceType: OperationOutcome
diff --git a/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier.yaml b/specification/examples/responses/GET_RelatedPerson/errors/invalid-identifier.yaml
@@ -4,13 +4,14 @@ RelatedPersonInvalidIdentifierError:
   value:
     issue:
       - code: invalid
-        diagnostics: "Not a valid NHS Number provided for the 'identifier' parameter"
-        expression: "RelatedPerson.identifier"
         details:
           coding:
             - "system": "https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode"
               version: "1"
               code: "INVALID_IDENTIFIER_VALUE"
               display: "Provided value is invalid"
+        diagnostics: "Not a valid NHS Number provided for the 'identifier' parameter"
+        expression: 
+          - "RelatedPerson.identifier"
         severity: error
     resourceType: "OperationOutcome"
diff --git a/specification/examples/responses/POST_Consent/errors/invalid_identifier_value.yaml b/specification/examples/responses/POST_Consent/errors/invalid_identifier_value.yaml
@@ -11,6 +11,7 @@ PostConsentInvalidIdentifierValueError:
               system: https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode
               version: "1"
         diagnostics: Performer identifier value is invalid
-        expression: performer[0].identifier.value
+        expression: 
+          - "performer[0].identifier.value"
         severity: error
     resourceType: OperationOutcome
diff --git a/specification/examples/responses/POST_Consent/errors/invalid_status.yaml b/specification/examples/responses/POST_Consent/errors/invalid_status.yaml
@@ -11,6 +11,7 @@ PostConsentInvalidStatusError:
               system: https://fhir.nhs.uk/R4/CodeSystem/ValidatedRelationships-ErrorOrWarningCode
               version: "1"
         diagnostics: Status is invalid
-        expression: status
+        expression: 
+          - "status"
         severity: error
     resourceType: OperationOutcome
-Original file line number
+Diff line change
@@ Expand Up / @@ -32,6 +32,7 @@ @@
                         }
                     ]
                 },
+                "diagnostics": "Resource that has been marked as invalid was requested - invalid resources cannot be retrieved",
                 "severity": "error"
             }
         ],
@@ Expand Down @@