API Documentation

Get Regulation Details

GET /api/v1/regulations/{id}

Get comprehensive information about a specific regulation including projects that comply with it and its geographic scope.

Request

Path Parameters

Parameter Type Required Description
id integer Yes Regulation ID

Example Request

bash
# Get details for regulation ID 50 (GDPR)
curl -X GET "https://www.weboftrust.org/api/v1/regulations/50" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Success Response (200 OK)

Response Schema

typescript
interface RegulationDetail {
  // Basic Information
  id: number;
  title: string;
  official_name?: string;    // Full legal title
  url?: string;              // Official regulation URL
  country?: {                // Specific country (if applicable)
    id: number;
    name: string;
    code: string;
  };
  region?: {                 // Geographic region
    title: string;
    abbreviation: string;
  };
  
  // AI-generated description
  ai_description?: string;
  
  // Projects following this regulation
  projects_following?: Array<{
    project: {
      id: number;
      title: string;
      type?: string;
      website?: string;
    };
    source?: string;        // URL confirming compliance
  }>;
  
  // Statistics
  stats: {
    total_links: number;     // Total number of relationships
  };
}

Example Response

json
{
  "id": 50,
  "title": "EU GDPR - EU General Data Protection Regulation",
  "official_name": "Regulation (EU) 2016/679 of the European Parliament and of the Council of 27 April 2016 (General Data Protection Regulation)",
  "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A02016R0679-20160504",
  "country": null,
  "region": {
    "title": "European Union",
    "abbreviation": "EU"
  },
  "ai_description": "The General Data Protection Regulation (GDPR) is a comprehensive data protection law that came into effect on May 25, 2018. It applies to all organizations processing personal data of EU residents, regardless of the organization's location, and establishes strict requirements for data protection, user consent, and privacy rights. GDPR introduced concepts like privacy by design, data portability, the right to be forgotten, and mandatory breach notifications, setting a global standard for data protection legislation.",
  "projects_following": [
    {
      "project": {
        "id": 325,
        "title": "EU Digital Identity Wallet",
        "type": "DID Project",
        "website": "https://ec.europa.eu/digital-building-blocks/sites/display/EUDIGITALIDENTITYWALLET/"
      },
      "source": "https://europa.eu/!Qq54DN"
    },
    {
      "project": {
        "id": 289,
        "title": "European Digital Credentials for Learning",
        "type": "DID Project",
        "website": "https://europa.eu/europass/en/europass-tools/european-digital-credentials"
      },
      "source": "https://europa.eu/europass/en/data-protection"
    }
  ],
  "stats": {
    "total_links": 179
  }
}

Error Responses

400 Bad Request

Invalid ID parameter

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

404 Not Found

Regulation not found

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

500 Internal Server Error

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

Field Descriptions

  • title: Common name or abbreviation
  • official_name: Complete legal title from official publication
  • url: Link to official legal text
  • country: Specific country jurisdiction (null for regional/international)
  • region: Broader geographic region (e.g., EU, APAC)
  • ai_description: AI-generated explanation of the regulation's scope and requirements
  • projects_following: Projects claiming compliance with this regulation
  • source: Verification URL for compliance claims