Create Subclient

POST

/client-service/api/v1/clients/{clientId}/sub-clients

Request

Path Params

Body Params application/json

Example

{
    "subClientType": "string",
    "businessName": "string",
    "registrationNumber": "string",
    "businessAddressLine1": "string",
    "businessAddressLine2": "string",
    "businessContactPhone": "string",
    "businessContactEmail": "string",
    "countryOfRegistration": "string",
    "registrationDate": "string",
    "operatingCountries": [
        "string"
    ],
    "operatingIndustries": [
        "string"
    ],
    "city": "string",
    "state": "string",
    "postalCode": "string",
    "tin": "string",
    "customerType": "string",
    "businessType": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-gateway-uat.mmacs.io/platform/client-service/api/v1/clients//sub-clients' \
--header 'Content-Type: application/json' \
--data-raw '{
    "subClientType": "string",
    "businessName": "string",
    "registrationNumber": "string",
    "businessAddressLine1": "string",
    "businessAddressLine2": "string",
    "businessContactPhone": "string",
    "businessContactEmail": "string",
    "countryOfRegistration": "string",
    "registrationDate": "string",
    "operatingCountries": [
        "string"
    ],
    "operatingIndustries": [
        "string"
    ],
    "city": "string",
    "state": "string",
    "postalCode": "string",
    "tin": "string",
    "customerType": "string",
    "businessType": "string"
}'

Responses

🟢200OK

application/json

success response

Body

Example

{
    "message": "Sub-Client information saved successfully",
    "entityId": "RURP9d_Mo-iIMVMZm2Qm2",
    "name": "Strosin Inc",
    "subClientType": "subsidiary",
    "businessContactPhone": "+2348864250026",
    "businessContactEmail": "Joesph.Isom.Ziemann@yopmail.com",
    "countryOfRegistration": "NGA",
    "stagesRemaining": [],
    "approvalStatus": "pending",
    "businessName": "Strosin Inc",
    "registrationDate": "2025-05-29",
    "businessAddressLine1": "32103 Linnea Trail",
    "businessAddressLine2": "55264 Dickinson Rue",
    "operatingCountries": [
        "USA",
        "NGA"
    ],
    "operatingIndustries": [
        "IT",
        "Real Estate"
    ],
    "status": "draft",
    "city": "Lagos",
    "state": "Lagos",
    "customerType": "corporate",
    "businessType": "Limited Liability Company",
    "createdAt": "2025-05-29T14:21:54.339Z",
    "updatedAt": "2025-05-29T14:21:54.339Z",
    "parentClientId": "9va0EY5wREalB8ESQRdgo",
    "callbackUrl": null,
    "tin": "XGBAVIW1626",
    "postalCode": "100002"
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-05-29 15:30:31

👋 Onboarding

Get All Subclients