Create KYC Token Address

Create a KYC token address association for a token.

Endpoint: POST /api/v1/integration/tokens/{token_id}/kyc-tokens

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration
Content-Type: application/json

Path Parameters

Parameter	Type	Required	Description
token_id	string (UUID)	Yes	Token ID

Request Body

{
  "kyc_address_id": "3b695a99-be80-4668-99af-254717524dd0",
  "chain_id": 1,
  "hash": "0x81948129849128491824981294",
  "is_approved": true
}

Request Parameters

Field	Type	Required	Description
kyc_address_id	string (UUID)	Yes	KYC Address ID
chain_id	integer	Yes	Blockchain network ID (e.g., 1 = Ethereum Mainnet, 137 = Polygon)
hash	string	Yes	Transaction or contract hash
is_approved	boolean	Yes	Whether the KYC token address is approved

Response

Status: 201 Created

Returns the created distributor KYC token object.

{
  "id": "e28cae58-0c9c-4f71-91b4-e567e06cc6a7",
  "distributor_id": "084a5159-1546-4ade-a7ba-956e0234a417",
  "kyc_address_id": "3b695a99-be80-4668-99af-254717524dd0",
  "token_id": "3c4da8b4-99e0-45ca-bb0b-221c3b1272b3",
  "chain_id": 1,
  "hash": "0x81948129849128491824981294",
  "is_approved": true,
  "created_at": "2025-12-24T19:09:11.407528+03:00",
  "updated_at": "2025-12-24T19:09:11.407528+03:00"
}

Example cURL Request

curl -X POST 'https://<base-url>/api/v1/integration/tokens/3c4da8b4-99e0-45ca-bb0b-221c3b1272b3/kyc-tokens' \
  -H "Content-Type: application/json" \
  -H "X-Target-Server: integration" \
  -H "Authorization: Bearer <access_token>" \
  -d '{
    "kyc_address_id": "3b695a99-be80-4668-99af-254717524dd0",
    "chain_id": 1,
    "hash": "0x81948129849128491824981294",
    "is_approved": true
  }'