Verify Identity

Register and verify a customer identity on-chain

POST /customers/api/identity/verify

cURL

curl -X POST "https://api.trusset.org/customers/api/identity/verify" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "softExpiryDays": 365,
    "hardExpiryDays": 730
  }'

Response

{
  "success": true,
  "data": {
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "status": "verified",
    "txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
    "gasUsed": "84521",
    "kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Writes a customer’s KYC verification to the on-chain identity registry. The address is checksummed, a KYC hash is computed, and the verification transaction is submitted to the instance’s configured network. The corresponding off-chain customer record is created or updated automatically.

Request Body

walletAddress · string · required

Ethereum wallet address to verify.

country · string · required

ISO country code (minimum 2 characters).

investorType · string · default: "RETAIL"

Investor classification. Values: RETAIL, PROFESSIONAL, INSTITUTIONAL.

softExpiryDays · integer

Number of days until the verification enters a soft-expired state. When set to 0 or omitted, no soft expiry is applied.

hardExpiryDays · integer

Number of days until the verification is fully expired on-chain. When set to 0 or omitted, no hard expiry is applied.

kycData · object

Optional custom data to include in the KYC hash computation. When omitted, the hash is derived from the wallet address, country, and current timestamp.

Response Fields

success · boolean

Request status

data · object

Show child attributes

walletAddress · string

Checksummed address

status · string

Always verified on success

txHash · string

On-chain transaction hash

gasUsed · string

Gas consumed by the transaction

kycHash · string

Computed KYC hash stored on-chain

cURL

curl -X POST "https://api.trusset.org/customers/api/identity/verify" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "investorType": "PROFESSIONAL",
    "softExpiryDays": 365,
    "hardExpiryDays": 730
  }'

Response

{
  "success": true,
  "data": {
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "status": "verified",
    "txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
    "gasUsed": "84521",
    "kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}