Update Subclient Shareholder

PATCH

/client-service/api/v1/clients/{clientId}/sub-clients/{id}/business-users/{shareholderId}

Request

Path Params

Body Params application/json

Example

{
    "title": "string",
    "firstName": "string",
    "lastName": "string",
    "gender": "male",
    "occupation": "Product Manager",
    "identificationType": " IDCARD",
    "identificationNumber": "string",
    "countryIso3Code": "string",
    "issuedDate": "string",
    "expiryDate": "string",
    "bvn": "string",
    "country": "string",
    "address": "string",
    "city": "string",
    "state": "string",
    "postalCode": "string",
    "dateOfBirth": "string",
    "contactEmail": "string",
    "contactPhone": "string",
    "meansOfIdentificationUrl": "string",
    "proofOfAddressUrl": "string",
    "designation": "BeneficialOwner",
    "shareholderPercentage": 0,
    "shareholderLevel": "string",
    "isUbo": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH 'https://api-gateway-uat.mmacs.io/platform/client-service/api/v1/clients//sub-clients//business-users/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "string",
    "firstName": "string",
    "lastName": "string",
    "gender": "male",
    "occupation": "Product Manager",
    "identificationType": " IDCARD",
    "identificationNumber": "string",
    "countryIso3Code": "string",
    "issuedDate": "string",
    "expiryDate": "string",
    "bvn": "string",
    "country": "string",
    "address": "string",
    "city": "string",
    "state": "string",
    "postalCode": "string",
    "dateOfBirth": "string",
    "contactEmail": "string",
    "contactPhone": "string",
    "meansOfIdentificationUrl": "string",
    "proofOfAddressUrl": "string",
    "designation": "BeneficialOwner",
    "shareholderPercentage": 0,
    "shareholderLevel": "string",
    "isUbo": true
}'

Responses

🟢200OK

application/json

success response

Body

Example

{
    "message": "Sub-Client user updated successfully",
    "id": "239",
    "entityId": "qaLGyVaQMSKXPKdYwqww2",
    "createdAt": "2025-05-29T16:48:14.100Z",
    "updatedAt": "2025-05-30T06:04:58.797Z",
    "createdBy": "abc.def@yopmail.com",
    "updatedBy": "abc.def@yopmail.com",
    "isDeleted": false,
    "businessUserId": null,
    "businessId": null,
    "title": "Prof",
    "firstName": "Gonzalo",
    "lastName": "Volkman",
    "gender": "Male",
    "dateOfBirth": "1991-03-01",
    "occupation": "System Engineer",
    "identificationType": "PASSPORT",
    "identificationNumber": "AVJIDZN1GOY",
    "issuedDate": "2024-09-01",
    "expiryDate": "2029-07-12",
    "bvn": "50252181664",
    "isHonorInstructionFromUser": null,
    "countryId": null,
    "countryIso3Code": "NGA",
    "country": "Nigeria",
    "address": "35492 Mayert Forks",
    "state": "Lagos",
    "city": "Lagos",
    "postalCode": "10001",
    "contactEmail": "Walker.Zack.Nienow@yopmail.com",
    "contactPhone": "+2348851060092",
    "meansOfIdentificationUrl": "https://boltsendblolb.blob.core.windows.net/supporting-document/450a95aa-9cdb-4376-a4d1-2c8d83917fa9-2024-8-2-7-25-1.png",
    "proofOfAddressUrl": null,
    "designation": "BeneficialOwner",
    "userRole": null,
    "shareholderPercentage": 80,
    "shareholderLevel": "Intermediate",
    "isUbo": false,
    "status": "active",
    "parentType": "subclient"
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-05-30 06:10:46

Get Subclient Shareholders

Upload Subclient Documents