Identity Verification
Verify Identity
Register and verify a customer identity on-chain
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
}'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/verify',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
investorType: 'PROFESSIONAL',
softExpiryDays: 365,
hardExpiryDays: 730
})
}
);
const { data } = await response.json();
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch('https://api.trusset.org/customers/api/identity/verify', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
txHash: tx.hash
})
});
import requests
response = requests.post(
'https://api.trusset.org/customers/api/identity/verify',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
json={
'walletAddress': '0xAbC123dEf456789012345678901234567890AbCd',
'country': 'DE',
'investorType': 'PROFESSIONAL',
'softExpiryDays': 365,
'hardExpiryDays': 730
}
)
data = response.json()['data']
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x3f8a1b2c..."
},
"functionName": "verifyIdentity",
"description": "Verify 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1781536000,
"operation": "verify",
"confirmWith": {
"endpoint": "POST /customers/api/identity/verify",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "verified",
"operation": "verify",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "84521",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ADDRESS",
"message": "Valid wallet address required"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
Registers a customer’s KYC verification on the on-chain identity registry. The address is checksummed and a KYC hash is computed, then the encoded registry call is returned for you to sign.
Call it once without
txHash to get the calldata, and again with txHash once you have broadcast it. The second call verifies the receipt and creates or updates the off-chain customer record.
The endpoint picks verifyIdentity or updateIdentity for you depending on whether the address is already on the registry, and reports which in operation.
Request Body
string
required
Ethereum wallet address to verify.
string
required
ISO country code (minimum 2 characters).
string
default:"RETAIL"
Investor classification. Values:
RETAIL, PROFESSIONAL, INSTITUTIONAL.integer
Number of days until the verification enters a soft-expired state. When set to
0 or omitted, no soft expiry is applied.integer
Number of days until the verification is fully expired on-chain. When set to
0 or omitted, no hard expiry is applied.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.
string
Hash of the transaction you broadcast. Send it to confirm the verification and write the customer record. Omit it to receive the calldata.
Response Fields
object
Show child attributes
Show child attributes
string
SIGN_TRANSACTION. Returned when txHash is omitted.object
to (the identity registry) and data. Returned when txHash is omitted.string
verifyIdentity or updateIdentity, whichever applies to this address. Returned when txHash is omitted.object
Where to send the hash once broadcast, as
endpoint and field. Returned when txHash is omitted.string
Checksummed address.
string
Computed KYC hash written on-chain. Pass the same value if you re-request calldata, or the hash will differ.
integer
Investor classification as the registry’s numeric enum. Returned when
txHash is omitted.integer
Soft expiry as a Unix timestamp, or
0 when unset. Returned when txHash is omitted.integer
Hard expiry as a Unix timestamp, or
0 when unset. Returned when txHash is omitted.string
verify or update.string
Always
verified. Returned when confirming with txHash.string
The confirmed transaction hash. Returned when confirming with
txHash.string
Gas consumed. Returned when confirming with
txHash.kycHash is derived from the current timestamp when you do not supply kycData. Requesting calldata twice produces two different hashes. Carry the kycHash from the calldata response through to your records, and confirm the transaction you actually broadcast.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
}'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/verify',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
investorType: 'PROFESSIONAL',
softExpiryDays: 365,
hardExpiryDays: 730
})
}
);
const { data } = await response.json();
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch('https://api.trusset.org/customers/api/identity/verify', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
txHash: tx.hash
})
});
import requests
response = requests.post(
'https://api.trusset.org/customers/api/identity/verify',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
json={
'walletAddress': '0xAbC123dEf456789012345678901234567890AbCd',
'country': 'DE',
'investorType': 'PROFESSIONAL',
'softExpiryDays': 365,
'hardExpiryDays': 730
}
)
data = response.json()['data']
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x3f8a1b2c..."
},
"functionName": "verifyIdentity",
"description": "Verify 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1781536000,
"operation": "verify",
"confirmWith": {
"endpoint": "POST /customers/api/identity/verify",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "verified",
"operation": "verify",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "84521",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ADDRESS",
"message": "Valid wallet address required"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
⌘I
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
}'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/verify',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
investorType: 'PROFESSIONAL',
softExpiryDays: 365,
hardExpiryDays: 730
})
}
);
const { data } = await response.json();
const tx = await wallet.sendTransaction(data.transaction);
await tx.wait();
await fetch('https://api.trusset.org/customers/api/identity/verify', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
country: 'DE',
txHash: tx.hash
})
});
import requests
response = requests.post(
'https://api.trusset.org/customers/api/identity/verify',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
json={
'walletAddress': '0xAbC123dEf456789012345678901234567890AbCd',
'country': 'DE',
'investorType': 'PROFESSIONAL',
'softExpiryDays': 365,
'hardExpiryDays': 730
}
)
data = response.json()['data']
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x3f8a1b2c..."
},
"functionName": "verifyIdentity",
"description": "Verify 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1781536000,
"operation": "verify",
"confirmWith": {
"endpoint": "POST /customers/api/identity/verify",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "verified",
"operation": "verify",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "84521",
"kycHash": "0xdeadbeef1234567890abcdef1234567890abcdef1234567890abcdef12345678"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ADDRESS",
"message": "Valid wallet address required"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}