Skip to main content
POST
/
customers
/
api
/
identity
/
verify
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
  }'

{
  "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
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
  }'

{
  "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"
  }
}