CAT-1760: create get applicant consents endpoint (#161)

Author: RiccardoPetteruti-Onfido

openapi.yaml

@@ -38,6 +38,8 @@ paths:
     $ref: paths/applicants.yaml#/applicant
   /applicants/{applicant_id}/restore:
     $ref: paths/applicants.yaml#/restore
+  /applicants/{applicant_id}/consents:
+    $ref: paths/applicants.yaml#/consents
   # Workflow Runs
   /workflow_runs:
     $ref: paths/workflow_runs.yaml#/workflow_runs

paths/applicants.yaml

@@ -153,3 +153,29 @@ restore:
         description: No Content
       default:
         $ref: ../responses/default_error.yaml
+
+consents:
+  get:
+    summary: Retrieve Applicant Consents
+    operationId: find_applicant_consents
+    description: >
+      Retrieves consents for single applicant.
+    parameters:
+      - name: applicant_id
+        in: path
+        required: true
+        schema:
+          type: string
+          format: uuid
+    responses:
+      "200":
+        description: Applicant Consents object
+        content:
+          application/json:
+            schema:
+              type: array
+              description: The applicant's consents
+              items:
+                $ref: "../schemas/applicants/definitions.yaml#/applicant_consent"
+      default:
+        $ref: ../responses/default_error.yaml

schemas/applicants/definitions.yaml

@@ -98,6 +98,23 @@ applicant_consent_builder:
     granted:
       type: boolean
 
+applicant_consent:
+  type: object
+  required:
+    - name
+    - granted
+    - granted_at
+  properties:
+    name:
+      $ref: "#/applicant_consent_name"
+    granted:
+      type: boolean
+    granted_at:
+      type: string
+      nullable: true
+      format: date-time
+      description: The date and time when this applicant consent was granted, if not granted the value is nil.
+
 applicant_consent_name:
   type: string
   enum: