Add directors (bulk)

POST

https://api.opensylo.com/api/v1/marketplace-api/merchants/{ref}/directors

Adds one or more directors/significant persons. BVN identities are
verified automatically; other identity types go to manual review.
Identity numbers are masked in all responses.

Request

Authorization

API Key

Add parameter in header

X-OpenSylo-Secret-Key

Example:

X-OpenSylo-Secret-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Created directors with verification status.

Bodyapplication/json

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.opensylo.com/api/v1/marketplace-api/merchants/mkt_merchant_8421/directors' \
--header 'X-OpenSylo-Secret-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "directors": [
        {
            "firstName": "string",
            "lastName": "string",
            "middleName": "string",
            "email": "user@example.com",
            "phoneNumber": "string",
            "address": "string",
            "dateOfBirth": "2019-08-24",
            "nationality": "string",
            "identityType": "BVN",
            "identityNumber": "string",
            "position": "CEO",
            "isPrimary": true
        }
    ]
}'

Response Example

200 - Example 1

[
    {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "position": "string",
        "isPrimary": true,
        "identityType": "string",
        "identityNumber": "****4351",
        "verificationStatus": "VERIFIED",
        "createdAt": "2019-08-24T14:15:22.123Z"
    }
]

Modified at 2026-06-10 14:59:36

Update business KYC information

Attach a KYC document