Batch Verify Identities

Verify multiple customer identities on-chain in a single transaction

POST /customers/api/identity/batch-verify

cURL

curl -X POST "https://api.trusset.org/customers/api/identity/batch-verify" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "entries": [
      { "walletAddress": "0xAbC123...", "country": "DE", "investorType": "PROFESSIONAL" },
      { "walletAddress": "0xDef456...", "country": "FR", "investorType": "RETAIL" }
    ]
  }'

Response

{
  "success": true,
  "data": {
    "totalEntries": 2,
    "txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
    "gasUsed": "168042"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Submits a batch of identity verifications to the on-chain registry. Invalid entries (malformed addresses, missing country) are silently filtered out. The remaining valid entries are verified in a single transaction and their off-chain records are created or updated.

Request Body

entries · array · required

Array of identity objects to verify. Minimum 1, maximum 500 entries. Each entry accepts the same fields as Verify Identity.

Show child attributes

entries[].walletAddress · string · required

Ethereum wallet address.

entries[].country · string · required

ISO country code.

entries[].investorType · string · default: "RETAIL"

Investor classification.

entries[].softExpiryDays · integer

Days until soft expiry.

entries[].hardExpiryDays · integer

Days until hard expiry.

Response Fields

success · boolean

Request status

data · object

Show child attributes

totalEntries · integer

Number of valid entries processed

txHash · string

On-chain transaction hash

gasUsed · string

Gas consumed by the batch transaction

cURL

curl -X POST "https://api.trusset.org/customers/api/identity/batch-verify" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "entries": [
      { "walletAddress": "0xAbC123...", "country": "DE", "investorType": "PROFESSIONAL" },
      { "walletAddress": "0xDef456...", "country": "FR", "investorType": "RETAIL" }
    ]
  }'

Response

{
  "success": true,
  "data": {
    "totalEntries": 2,
    "txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
    "gasUsed": "168042"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}