API Documentation

Search Across All Resources

GET /api/v1/search

Search across all resource types in the Web of Trust Map database. Returns top results from projects, entities, people, DLTs, regulations, standards, DID methods, and geographic regions.

Features

  • Searches name fields across all resource types
  • Returns up to 5 results per resource type
  • Case-insensitive matching
  • Partial string matching supported
  • Results ordered by relevance and score

Request

Query Parameters

Parameter Type Required Description
query string No Search text. If omitted, returns all resources (limited to 5 per type)

Example Request

bash 
# Search for "ethereum"
curl -X GET "https://www.weboftrust.org/api/v1/search?query=ethereum" \
  -H "X-API-Key: YOUR_API_KEY"

# Get all resources (no search filter)
curl -X GET "https://www.weboftrust.org/api/v1/search" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Returns an array of search results with mixed resource types.

Response Headers

Header Value Description
X-License CC-BY-4.0 License identifier
X-Attribution Web of Trust Map – Key State Capital Required attribution

Response Schema

json 
[
  {
    "id": "string",          // Prefixed resource ID (e.g., "project-123")
    "title": "string",       // Display name of the resource
    "type": "string",        // Resource type or subtype
    "code": "string | null", // Country/region code (geographic entities only)
    "countryFilter": "string | null",  // Country filter (countries only)
    "regionFilter": "string | null"    // Region filter (regions only)
  }
]

Resource Types

The type field indicates the resource category:

  • DID Project - Decentralized identity project
  • Consortium - Industry consortium
  • Public - Public sector entity
  • Private - Private sector entity
  • Person - Person of interest
  • dltinstance - Blockchain instance
  • dlt - DLT technology
  • Regulation - Regulatory framework
  • Standard - Technical standard
  • Country - Country
  • Region - Geographic region
  • DID Method - DID method specification

Example Response

json 
[
  {
    "id": "project-118",
    "title": "TradeTrust",
    "type": "DID Project",
    "code": null,
    "countryFilter": null,
    "regionFilter": null
  },
  {
    "id": "entity-3",
    "title": "Microsoft Corporation",
    "type": "Private",
    "code": null,
    "countryFilter": null,
    "regionFilter": null
  },
  {
    "id": "dltinstance-2",
    "title": "Ethereum",
    "type": "dltinstance",
    "code": null,
    "countryFilter": null,
    "regionFilter": null
  },
  {
    "id": "standard-12",
    "title": "W3C Verifiable Credentials Data Model",
    "type": "Standard",
    "code": null,
    "countryFilter": null,
    "regionFilter": null
  },
  {
    "id": "country-197",
    "title": "United States of America",
    "type": "Country",
    "code": "US",
    "countryFilter": "US",
    "regionFilter": null
  }
]

Error Responses

500 Internal Server Error

json 
{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch search results"
  }
}

Usage Tips

  • Search is performed on name/title fields only
  • For DID methods, search without the "did:" prefix (e.g., search for "ethr" not "did:ethr")
  • Results are limited to 5 per resource type to ensure fast response times
  • For more comprehensive results within a specific resource type, use the dedicated list endpoints
  • The search is case-insensitive and supports partial matches