NPA-4749 Allow GET Consent Patient Identifier Input

Author: JackPlowman

specification/validated-relationships-service-api.yaml

@@ -474,6 +474,7 @@ paths:
       parameters:
         - $ref: "#/components/parameters/BearerAuthorization"
         - $ref: "#/components/parameters/ConsentBundlePerformerIdentifier"
+        - $ref: "#/components/parameters/ConsentBundlePatientIdentifier"
         - $ref: "#/components/parameters/ConsentStatus"
         - $ref: "#/components/parameters/ConsentBundleIncludes"
         - $ref: "#/components/parameters/RequestID"
@@ -520,7 +521,7 @@ paths:
             | ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
             | 400         | `MISSING_VALUE`             | Missing header or parameter. For details, see the `diagnostics` field.                                                                    |
             | 400         | `INVALID_VALUE`             | Invalid header. For details, see the `diagnostics` field.                                                                                 |
-            | 400         | `MISSING_IDENTIFIER_VALUE`  | Missing performer NHS number.                                                                                                             |
+            | 400         | `MISSING_IDENTIFIER_VALUE`  | Missing NHS number.                                                                                                             |
             | 400         | `NOT_SUPPORTED`             | The request is not currently supported.                                                                                                   |
             | 401         | `ACCESS_DENIED`             | Missing or invalid OAuth 2.0 bearer token in request.                                                                                     |
             | 403         | `FORBIDDEN`                 | Access denied to resource.                                                                                                                |
@@ -529,7 +530,7 @@ paths:
             | 405         | `METHOD_NOT_ALLOWED`        | The method is not allowed.                                                                                                                |
             | 408         | `TIMEOUT`                   | Request timed out.                                                                                                                        |
             | 422         | `INVALID_IDENTIFIER_SYSTEM` | Invalid identifier system.                                                                                                                |
-            | 422         | `INVALID_IDENTIFIER_VALUE`  | Malformed performer NHS number.                                                                                                           |
+            | 422         | `INVALID_IDENTIFIER_VALUE`  | Malformed NHS number.                                                                                                           |
             | 422         | `INVALID_PARAMETER`         | Invalid parameter. For details, see the `diagnostics` field.                                                                              |
             | 429         | `THROTTLED`                 | You have exceeded your application's [rate limit](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#rate-limits). |
 
@@ -2331,8 +2332,25 @@ components:
       in: query
       name: performer:identifier
       description: |
-        The performer's (Proxy) NHS number. For more information on FHIR tokens in general, [see here](https://build.fhir.org/search.html#token).
-      required: true
+        The performer's (Proxy) NHS number. One of `performer:identifier` or `patient:identifier` is required. For more information on FHIR tokens in general, [see here](https://build.fhir.org/search.html#token).
+      required: false
+      schema:
+        type: string
+        format: token
+      examples:
+        withoutSystem:
+          value: 9000000017
+          summary: NHS number specified without system
+        withSystem:
+          value: https://fhir.nhs.uk/Id/nhs-number|9000000017
+          summary: System and NHS number specified
+
+    ConsentBundlePatientIdentifier:
+      in: query
+      name: patient:identifier
+      description: |
+        The patient's NHS number. One of `performer:identifier` or `patient:identifier` is required. For more information on FHIR tokens in general, [see here](https://build.fhir.org/search.html#token).
+      required: false
       schema:
         type: string
         format: token