Trusset Protocol - Infrastructure for Asset Tokenization

POST

customers

api

id-links

curl -X POST "https://api.trusset.org/customers/api/id-links" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "channels": ["email"]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/id-links',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      email: '[email protected]',
      walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
      country: 'DE',
      channels: ['email']
    })
  }
);
const { data: link } = await response.json();

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "url": "https://verify.trusset.org/link_abc123",
    "status": "pending",
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "expiresAt": "2025-06-22T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Creates a new identity verification link that can be sent to a customer to complete their KYC process. The link connects to the configured identity provider (e.g., Sumsub) and, upon successful completion, triggers the on-chain identity verification.

Request Body

The request body is passed directly to the ID link service. Required fields depend on the identity provider configuration for your instance.

string

Customer email address. Used to send the verification link.

string

Ethereum wallet address to associate with the verification.

string

ISO country code for the customer.

string[]

Delivery channels for the link (e.g., ["email"], ["sms"], ["email", "sms"]).

object

Arbitrary metadata to attach to the link.

Response Fields

boolean

Request status

object

The created ID link object, including the generated link URL and its current status.

curl -X POST "https://api.trusset.org/customers/api/id-links" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "channels": ["email"]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/id-links',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      email: '[email protected]',
      walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
      country: 'DE',
      channels: ['email']
    })
  }
);
const { data: link } = await response.json();

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "url": "https://verify.trusset.org/link_abc123",
    "status": "pending",
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "expiresAt": "2025-06-22T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Check Transfer Compliance

List ID Links

curl -X POST "https://api.trusset.org/customers/api/id-links" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: trusset_abc123xy_secret..." \
  -d '{
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "country": "DE",
    "channels": ["email"]
  }'

const response = await fetch(
  'https://api.trusset.org/customers/api/id-links',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'trusset_abc123xy_secret...'
    },
    body: JSON.stringify({
      email: '[email protected]',
      walletAddress: '0xAbC123dEf456789012345678901234567890AbCd',
      country: 'DE',
      channels: ['email']
    })
  }
);
const { data: link } = await response.json();

{
  "success": true,
  "data": {
    "id": "link_abc123",
    "url": "https://verify.trusset.org/link_abc123",
    "status": "pending",
    "email": "[email protected]",
    "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
    "createdAt": "2025-06-15T12:00:00.000Z",
    "expiresAt": "2025-06-22T12:00:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Create ID Link

Request Body

Response Fields

​Request Body

​Response Fields

Request Body

Response Fields