flatten beneficialOwner.personalInfo.personalIds; make ownershipPercentage required (#289)

Author: wuvictor-95

mintlify/openapi.yaml

@@ -24,12 +24,11 @@ properties:
       - UBO
       - DIRECTOR
   ownershipPercentage:
-    type: number
-    format: float
+    type: integer
     description: Percentage of ownership in the business (0-100)
     minimum: 0
     maximum: 100
-    example: 51.0
+    example: 51
   personalInfo:
     $ref: ./BeneficialOwnerPersonalInfo.yaml
   kycStatus:

openapi.yaml

@@ -2,6 +2,7 @@ type: object
 required:
   - customerId
   - roles
+  - ownershipPercentage
   - personalInfo
 properties:
   customerId:
@@ -17,11 +18,10 @@ properties:
       - UBO
       - DIRECTOR
   ownershipPercentage:
-    type: number
-    format: float
+    type: integer
     description: Percentage of ownership in the business (0-100). Relevant when role includes UBO.
     minimum: 0
     maximum: 100
-    example: 51.0
+    example: 51
   personalInfo:
     $ref: ./BeneficialOwnerPersonalInfo.yaml

openapi/components/schemas/customers/BeneficialOwner.yaml

@@ -5,20 +5,21 @@ required:
   - birthDate
   - nationality
   - address
-  - personalIds
+  - idType
+  - identifier
 properties:
   firstName:
     type: string
     description: First name of the individual
     example: Jane
-  lastName:
-    type: string
-    description: Last name of the individual
-    example: Smith
   middleName:
     type: string
     description: Middle name of the individual
     example: Marie
+  lastName:
+    type: string
+    description: Last name of the individual
+    example: Smith
   birthDate:
     type: string
     format: date
@@ -40,5 +41,13 @@ properties:
     pattern: '^\+[1-9]\d{1,14}$'
   address:
     $ref: ../common/Address.yaml
-  personalIds:
-    $ref: ./PersonalIdentification.yaml
+  idType:
+    $ref: ./IdentificationType.yaml
+  identifier:
+    type: string
+    description: The identification number or value
+    example: 123-45-6789
+  countryOfIssuance:
+    type: string
+    description: Country that issued the identification (ISO 3166-1 alpha-2)
+    example: US