API Documentation

List DLT Technologies

GET /api/v1/dlts

Get a paginated list of DLT (Distributed Ledger Technology) technologies with optional search, project inclusion, and instance inclusion. DLT technologies are the underlying blockchain protocols like Ethereum, Hyperledger Indy, or Corda. Some DLTs have multiple instances based on them (for instance Hyperledger Indy), while for others there is one entry in DLT and one in DLT instances. You can include instances directly in this response with the include_instances parameter, or query all instances for a specific DLT using the /api/v1/dlts/{id} endpoint

Request

Query Parameters

Parameter Type Required Default Description
page integer No 1 Page number (1-indexed)
per_page integer No 20 Results per page (1-100)
q string No - Search text for DLT names
include_projects boolean No false Include list of all projects using each DLT
include_instances boolean No false Include list of all blockchain instances based on each DLT

Example Requests

bash 
# Get first page of DLT technologies
curl -X GET "https://www.weboftrust.org/api/v1/dlts" \
  -H "X-API-Key: YOUR_API_KEY"

# Search for "hyperledger" technologies
curl -X GET "https://www.weboftrust.org/api/v1/dlts?q=hyperledger" \
  -H "X-API-Key: YOUR_API_KEY"

# Get DLT technologies with their projects
curl -X GET "https://www.weboftrust.org/api/v1/dlts?include_projects=true" \
  -H "X-API-Key: YOUR_API_KEY"

# Get DLT technologies with their instances
curl -X GET "https://www.weboftrust.org/api/v1/dlts?include_instances=true" \
  -H "X-API-Key: YOUR_API_KEY"

# Get DLT technologies with both projects and instances
curl -X GET "https://www.weboftrust.org/api/v1/dlts?include_projects=true&include_instances=true" \
  -H "X-API-Key: YOUR_API_KEY"

# Get page 3 with 50 results
curl -X GET "https://www.weboftrust.org/api/v1/dlts?page=3&per_page=50" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript 
interface DltListResponse {
  data: DltSummary[];
  pagination: {
    page: number;       // Current page (1-indexed)
    per_page: number;   // Items per page
    total: number;      // Total number of DLT technologies
    total_pages: number; // Total number of pages
  };
}

interface DltSummary {
  id: number;
  title: string;
  type?: string;                    // e.g., "Public PoS", "Public PoA", "Private"
  has_specific_operator?: boolean | null;  // Whether DLT has a specific operator
  website?: string;
  logo_url?: string;
  instance_count: number;           // Number of blockchain instances based on this DLT
  stats: {
    total_links: number;
  };
  projects?: ProjectUsage[];        // Only included when include_projects=true (all projects)
  instances?: DltInstance[];        // Only included when include_instances=true (all instances)
}

interface ProjectUsage {
  id: number;
  title: string;
  type: "DID Project" | "Consortium";
  status?: string;
  source?: string;    // URL confirming project uses this DLT technology
}

interface DltInstance {
  id: number;
  name: string;
  website?: string;
  operator?: {
    id: number;
    name: string;
  };
}

Example Response (without projects)

json 
{
  "data": [
    {
      "id": 4,
      "title": "Hyperledger Indy",
      "type": "Public PoA",
      "has_specific_operator": true,
      "website": "https://www.lfdecentralizedtrust.org/projects/hyperledger-indy",
      "logo_url": "https://weboftrust.org/icons-overwrite/lfdecentralizedtrust.org.webp",
      "instance_count": 17,
      "stats": {
        "total_links": 20
      }
    },
    {
      "id": 16,
      "title": "Tendermint",
      "type": "Public PoS",
      "has_specific_operator": false,
      "website": "https://tendermint.com/",
      "logo_url": "https://weboftrust.org/icons/tendermint.com.webp",
      "instance_count": 7,
      "stats": {
        "total_links": 8
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 2,
    "total": 142,
    "total_pages": 71
  }
}

Example Response (with projects)

json 
{
  "data": [
    {
      "id": 4,
      "title": "Hyperledger Indy",
      "type": "Public PoA",
      "has_specific_operator": true,
      "website": "https://www.lfdecentralizedtrust.org/projects/hyperledger-indy",
      "logo_url": "https://weboftrust.org/icons-overwrite/lfdecentralizedtrust.org.webp",
      "instance_count": 17,
      "stats": {
        "total_links": 20
      },
      "projects": [
        {
          "id": 32,
          "title": "Sovrin Network",
          "type": "DID Project",
          "status": "Launched",
          "source": "https://sovrin.org/the-sovrin-network/"
        },
        {
          "id": 145,
          "title": "BC Digital ID",
          "type": "DID Project",
          "status": "Pilot",
          "source": "https://digital.gov.bc.ca/digital-trust/projects-and-initiatives/bc-digital-identity/"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 142,
    "total_pages": 142
  }
}

Example Response (with instances)

json 
{
  "data": [
    {
      "id": 4,
      "title": "Hyperledger Indy",
      "type": "Public PoA",
      "has_specific_operator": true,
      "website": "https://www.lfdecentralizedtrust.org/projects/hyperledger-indy",
      "logo_url": "https://weboftrust.org/icons-overwrite/lfdecentralizedtrust.org.webp",
      "instance_count": 17,
      "stats": {
        "total_links": 20
      },
      "instances": [
        {
          "id": 32,
          "name": "Sovrin",
          "website": "https://sovrin.org/",
          "operator": {
            "id": 82,
            "name": "Sovrin Foundation"
          }
        },
        {
          "id": 1,
          "name": "IDunion",
          "website": "https://idunion.org/",
          "operator": {
            "id": 3302,
            "name": "IDunion SCE mit beschränkter Haftung"
          }
        },
        {
          "id": 145,
          "name": "Indicio",
          "website": "https://indicio.tech/",
          "operator": {
            "id": 875,
            "name": "Indicio PBC"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 142,
    "total_pages": 142
  }
}

Error Responses

400 Bad Request

Invalid query parameters

json 
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid page parameter"
  }
}

500 Internal Server Error

json 
{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch DLT technologies"
  }
}

Understanding DLT Technologies

Types of DLT Technologies

By Consensus Mechanism

  • Proof of Stake (PoS): Ethereum 2.0, Cardano, Polkadot
  • Proof of Authority (PoA): Hyperledger Besu, VeChain
  • PBFT variants: Hyperledger Fabric, Hyperledger Indy
  • Proof of Work (PoW): Bitcoin, Ethereum 1.0
  • Novel mechanisms: Hedera Hashgraph, IOTA Tangle

By Access Model

  • Public: Open participation (Ethereum, Bitcoin)
  • Permissioned: Known participants (Hyperledger Indy)
  • Private: Restricted access (Hyperledger Fabric)
  • Hybrid: Mixed models (R3 Corda)

Enterprise Platforms

  • Hyperledger Fabric - Modular enterprise blockchain
  • Hyperledger Indy - Identity-focused blockchain
  • Hyperledger Besu - Ethereum-compatible enterprise
  • R3 Corda - Financial services platform
  • Quorum - Enterprise Ethereum fork

Public Platforms

  • Ethereum - Smart contract platform
  • Bitcoin - Original cryptocurrency
  • Polkadot - Multi-chain network
  • Cardano - Research-driven blockchain
  • Algorand - High-performance blockchain

Specialized Technologies

  • Hedera Hashgraph - DAG-based consensus
  • IOTA - IoT-focused Tangle
  • Stellar - Payment network
  • Ripple - Financial settlement

Field Descriptions

  • type: Classification by consensus and access model
  • has_specific_operator: Whether instances require specific operators
  • instance_count: Number of deployed blockchain instances
  • stats.total_links: Total connections to projects and entities
  • projects: Sample of projects using this technology (max 10)

Use Cases

  • Technology Evaluation: Compare different blockchain platforms
  • Architecture Planning: Choose appropriate DLT for requirements
  • Ecosystem Analysis: Understand technology adoption patterns
  • Market Research: Identify trending platforms
  • Partnership Discovery: Find projects using similar technology

Selection Criteria

When choosing a DLT technology, consider:

  • Performance: Transaction throughput and latency
  • Scalability: Network growth capacity
  • Privacy: Data confidentiality features
  • Governance: Decision-making structure
  • Ecosystem: Developer tools and community
  • Cost: Transaction fees and infrastructure

Performance Considerations

  • Base response is lightweight (technology list only)
  • Setting include_projects=true can significantly increase response size (includes all projects)
  • Setting include_instances=true can significantly increase response size (includes all instances)
  • Setting both include_projects=true and include_instances=true provides the most comprehensive data but with the largest response size
  • Results are cached for performance