Delegated Verification Guide

Step 1: Request API Key

Step 2: Receive Credentials

You'll receive:

• API Key: api_key_example_not_real_xxxxxxxxxxxxxxxx
• Documentation: This guide
• Sandbox API Key: For testing

Step 3: Integrate API

Use the API endpoint to issue credentials to your users.

Node.js / TypeScript

import fetch from 'node-fetch';

async function issueCardlessId(
  walletAddress: string,
  userData: {
    firstName: string;
    lastName: string;
    dateOfBirth: string;
  }
) {
  const response = await fetch('https://cardlessid.com/api/delegated-verification/issue', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      apiKey: process.env.CARDLESSID_API_KEY,
      walletAddress,
      identity: userData
    })
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`Failed to issue credential: ${error.error}`);
  }

  const result = await response.json();
  console.log('Credential issued:', result.credentialId);

  return result;
}

// Usage
await issueCardlessId(
  'MWCAXBUMUK3I2NTVEHDA6JVQ2W7IMKJUJSGEKQTRMFYYE3W6GJUSHUAGJM',
  {
    firstName: 'Jane',
    lastName: 'Doe',
    dateOfBirth: '1990-01-15'
  }
);

Python

import requests
import os

def issue_cardless_id(wallet_address, user_data):
    response = requests.post(
        'https://cardlessid.com/api/delegated-verification/issue',
        json={
            'apiKey': os.environ['CARDLESSID_API_KEY'],
            'walletAddress': wallet_address,
            'identity': user_data
        }
    )

    response.raise_for_status()
    result = response.json()

    print(f"Credential issued: {result['credentialId']}")
    return result

# Usage
issue_cardless_id(
    'MWCAXBUMUK3I2NTVEHDA6JVQ2W7IMKJUJSGEKQTRMFYYE3W6GJUSHUAGJM',
    {
        'firstName': 'Jane',
        'lastName': 'Doe',
        'dateOfBirth': '1990-01-15'
    }
)

cURL

curl -X POST https://cardlessid.com/api/delegated-verification/issue \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key_here_not_a_real_key_example",
    "walletAddress": "MWCAXBUMUK3I2NTVEHDA6JVQ2W7IMKJUJSGEKQTRMFYYE3W6GJUSHUAGJM",
    "identity": {
      "firstName": "Jane",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-15",
      "documentNumber": "D1234567",
      "documentType": "government_id",
      "issuingCountry": "US",
      "issuingState": "CA"
    }
  }'