Skip to main content

Add Multiple Members to KYC Group

Adds multiple user addresses to a KYC group in a single request.

Request

POST /v2/admin/kyc/groups/{groupID}/members/bulk

Parameters

NameTypeInDescription
groupIDstringpathRequired. The ID of the KYC group
group_idstringbodyRequired. The ID of the KYC group (must match path parameter)
user_addressesarraybodyRequired. Array of wallet addresses to add (min: 1, max: 100)

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication
Content-TypeRequired. Must be application/json

Request Body

{
"group_id": "67d8774e903bfcbe7eb5d93e",
"user_addresses": [
"0x1234567890123456789012345678901234567890",
"0x0987654321098765432109876543210987654321"
]
}

Example

curl --request POST \
--url '{{baseUrl}}/v2/admin/kyc/groups/67d8774e903bfcbe7eb5d93e/members/bulk' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'Content-Type: application/json' \
--data '{
"group_id": "67d8774e903bfcbe7eb5d93e",
"user_addresses": [
"0x1234567890123456789012345678901234567890",
"0x0987654321098765432109876543210987654321"
]
}'

Response

A successful request returns an HTTP 201 status code with the action response.

{
"requires_approval": false,
"completed": true
}

Response Fields

FieldTypeDescription
requires_approvalbooleanWhether the action requires approval
completedbooleanWhether the action was completed immediately

Status Codes

Status CodeDescription
201Success - Members added to KYC group
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing authentication token
404Not Found - KYC group ID does not exist
409Conflict - One or more members already exist in the group
500Internal Server Error