API Documentation

Get Standard Details

GET /api/v1/standards/{id}

Get comprehensive information about a specific standard including all projects implementing it and managing organizations.

Request

Path Parameters

Parameter Type Required Description
id integer Yes Standard ID

Example Request

bash 
# Get details for standard ID 12 (W3C Verifiable Credentials)
curl -X GET "https://www.weboftrust.org/api/v1/standards/12" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript 
interface StandardDetail {
  // Basic Information
  id: number;
  title: string;
  url?: string;                     // Official specification URL
  
  // AI-generated description
  ai_description?: string;
  
  // Projects implementing this standard
  projects_following_count: number;  // Total count
  projects_following?: Array<{
    project: {
      id: number;
      title: string;
      type?: string;
      website?: string;
    };
    source?: string;               // URL confirming implementation
  }>;
  
  // Projects managing this standard
  projects_managing?: Array<{
    project: {
      id: number;
      title: string;
      type?: string;
      website?: string;
    };
    source?: string;
  }>;
  
  // Statistics
  stats: {
    total_links: number;            // Total number of relationships
  };
}

Example Response

json 
{
  "id": 12,
  "title": "W3C Verifiable Credentials Data Model",
  "url": "https://www.w3.org/TR/vc-data-model/",
  "ai_description": "The W3C Verifiable Credentials Data Model is a specification that defines how to express credentials on the Web in a way that is cryptographically secure, privacy-respecting, and machine-verifiable. It provides a standard way to express credentials such as driver's licenses, educational certificates, and other qualifications in a digital format that can be verified without contacting the issuer.",
  "projects_following_count": 205,
  "projects_following": [
    {
      "project": {
        "id": 398,
        "title": "XATP",
        "type": "DID Project",
        "website": "https://ledgerdomain.com/"
      },
      "source": "https://archive.ph/zK4ij#39%"
    },
    {
      "project": {
        "id": 149,
        "title": "AU10TIX Reusable Digital ID",
        "type": "DID Project",
        "website": "https://www.au10tix.com/"
      },
      "source": "https://archive.ph/cUVfv"
    },
    {
      "project": {
        "id": 118,
        "title": "TradeTrust",
        "type": "DID Project",
        "website": "https://www.tradetrust.io/"
      },
      "source": "https://archive.li/UpHV3#52%"
    }
  ],
  "projects_managing": [],
  "stats": {
    "total_links": 215
  }
}

Error Responses

400 Bad Request

Invalid ID parameter

json 
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid standard ID"
  }
}

404 Not Found

Standard not found

json 
{
  "error": {
    "code": "not_found",
    "message": "Standard not found"
  }
}

500 Internal Server Error

json 
{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch standard details"
  }
}

Field Descriptions

  • title: Official name of the standard
  • url: Link to the official specification
  • ai_description: AI-generated explanation of the standard's purpose and technical details
  • projects_following_count: Total number of projects implementing this standard
  • projects_following: List of projects that have adopted this standard
  • projects_managing: Organizations responsible for maintaining the standard
  • source: Verification URL confirming a project's implementation

Key Standards in Digital Identity

W3C Standards

Verifiable Credentials Data Model

  • Defines the VC format and structure
  • Supports JSON and JSON-LD
  • Enables cryptographic proofs
  • Privacy-preserving selective disclosure

Decentralized Identifiers (DIDs)

  • Globally unique identifiers
  • User-controlled identity
  • Cryptographically verifiable
  • Resolution to DID documents

DID Resolution

  • Defines how to resolve DIDs
  • Specifies DID document format
  • Handles DID URL dereferencing

ISO Standards

ISO/IEC 18013-5 (mDL)

  • Mobile driving license standard
  • Defines data model and protocols
  • Privacy-preserving presentation
  • Offline verification support

ISO/IEC 23220

  • Identity management and privacy
  • Framework for ID systems
  • Privacy protection guidelines

OpenID Standards

OpenID Connect

  • Identity layer on OAuth 2.0
  • User authentication protocol
  • ID token specification
  • Standard claims

OpenID for Verifiable Credentials

  • VC issuance over OpenID
  • Presentation protocols
  • Wallet interactions

Standards often work together:

  • VCs + DIDs for complete identity solution
  • OpenID Connect + OAuth for authentication/authorization
  • ISO mDL + W3C VCs for government credentials
  • FIDO + WebAuthn for passwordless authentication