Submit partner-attested KYC or KYB evidence

POST

/partner/v1/customers/{customerId}/onboarding-submissions

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "customerType": "INDIVIDUAL",
    "consentEvidence": {
        "property1": "string",
        "property2": "string"
    },
    "partnerAttestation": {
        "property1": "string",
        "property2": "string"
    },
    "fileAssetIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "submission": {
        "personalDetails": {
            "firstName": "string",
            "lastName": "string",
            "dateOfBirth": "2019-08-24",
            "nationality": "st",
            "residentialAddress": {
                "country": "st",
                "city": "string",
                "postcode": "string",
                "addressLine1": "string"
            },
            "contactNumber": {
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "user@example.com",
            "taxResidency": "st"
        },
        "additionalPersonalDetails": {
            "occupation": "string",
            "purposesOfAccountOpening": [
                "string"
            ],
            "sourceOfFunds": [
                "string"
            ],
            "sourceOfWealth": [
                "string"
            ]
        },
        "supportingDocuments": [
            {
                "fileAssetId": "ff609797-f24d-4a85-b1cd-e0fde45821c2",
                "documentType": "string"
            }
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/customers//onboarding-submissions' \
--header 'X-Partner-Client-Id;' \
--header 'X-Partner-Timestamp;' \
--header 'X-Partner-Nonce;' \
--header 'X-Partner-Signature;' \
--header 'X-Request-Id;' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerType": "INDIVIDUAL",
    "consentEvidence": {
        "property1": "string",
        "property2": "string"
    },
    "partnerAttestation": {
        "property1": "string",
        "property2": "string"
    },
    "fileAssetIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "submission": {
        "personalDetails": {
            "firstName": "string",
            "lastName": "string",
            "dateOfBirth": "2019-08-24",
            "nationality": "st",
            "residentialAddress": {
                "country": "st",
                "city": "string",
                "postcode": "string",
                "addressLine1": "string"
            },
            "contactNumber": {
                "countryCode": "string",
                "phoneNumber": "string"
            },
            "email": "user@example.com",
            "taxResidency": "st"
        },
        "additionalPersonalDetails": {
            "occupation": "string",
            "purposesOfAccountOpening": [
                "string"
            ],
            "sourceOfFunds": [
                "string"
            ],
            "sourceOfWealth": [
                "string"
            ]
        },
        "supportingDocuments": [
            {
                "fileAssetId": "ff609797-f24d-4a85-b1cd-e0fde45821c2",
                "documentType": "string"
            }
        ]
    }
}'

Responses

🟢202Accepted

application/json

Onboarding evidence accepted for processing.

Bodyapplication/json

Example

{
    "submissionId": "23243110-f447-42f4-a433-27cb8d276b19",
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
    "customerType": "INDIVIDUAL",
    "status": "string"
}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409

Modified at 2026-06-28 00:04:35

Upload or link a file to a partner customer

List partner customer balances