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

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

# Get regulations from the European Union
curl -X GET "https://www.weboftrust.org/api/v1/regulations?country=EU" \
  -H "X-API-Key: YOUR_API_KEY"

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

interface RegulationListResponse {
  data: RegulationSummary[];
  pagination: {
    page: number;       // Current page (1-indexed)
    per_page: number;   // Items per page
    total: number;      // Total number of regulations
    total_pages: number; // Total number of pages
  };
}

interface RegulationSummary {
  id: number;
  title: string;
  official_name?: string;   // Full legal name
  url?: string;             // Official regulation URL
  country?: {               // Originating country/region
    id: number;
    name: string;
    code: string;
  };
  stats: {
    total_links: number;     // Number of projects following this regulation
  };
}

{
  "data": [
    {
      "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,
      "stats": {
        "total_links": 179
      }
    },
    {
      "id": 1,
      "title": "eIDAS - electronic IDentification, Authentication and trust Services Regulation",
      "official_name": "Regulation (EU) No 910/2014 of the European Parliament and of the Council of 23 July 2014",
      "url": "https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation",
      "country": null,
      "stats": {
        "total_links": 66
      }
    },
    {
      "id": 23,
      "title": "California Consumer Privacy Act (CCPA)",
      "official_name": "California Consumer Privacy Act of 2018",
      "url": "https://oag.ca.gov/privacy/ccpa",
      "country": {
        "id": 197,
        "name": "United States of America",
        "code": "US"
      },
      "stats": {
        "total_links": 42
      }
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 3,
    "total": 46,
    "total_pages": 16
  }
}

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

{
  "error": {
    "code": "internal_error",
    "message": "Failed to fetch regulations"
  }
}