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
Related Endpoints
- GET /regulations - List all regulations
- GET /projects/{id} - Get project details including regulatory compliance
- GET /countries - Get countries with their regulations
- GET /search - Search across all resources