Submit entity data for KYC requirements

POST

/entity-data

Submits field data for an entity to fulfill KYC requirements. Each submitted field is validated against the requirement set for the entity's category and country. Fields may be approved, marked as pending review, or rejected based on validation rules. The entity ID is extracted from the authentication token and cannot be overridden.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Entity data submitted and processed successfully. The response includes the list of submitted fields with their validation results and the recalculated KYC status for the entity.

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Single field submissionMultiple fields submitted together

curl --location '/entity-data' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "full_name": "John Doe"
    }
}'

Response Example

201 - Success

{
    "message": "Entity data submitted successfully",
    "status": "success",
    "data": {
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
        "kyc_status": "in_review",
        "results": [
            {
                "id": "01HQZR2BKPFQ8MXJVT3G7LWN5",
                "field_name": "full_name",
                "status": "approved",
                "status_reason": null
            },
            {
                "id": "01HQZR2BKPFQ8MXJVT3G7LWN6",
                "field_name": "date_of_birth",
                "status": "pending",
                "status_reason": null
            }
        ]
    }
}

Modified at 2026-09-23 15:44:30

Retrieve the data submission checklist for an entity

List entity data