EuroGPSR API Documentation

Run a new compliance scan

Request

curl -X POST https://eurogpsr.com/api/v1/scan \
  -H "Authorization: Bearer egpsr_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example-store.com"}'

Response (200 OK)

{
  "scanId": "sc_01HX...",
  "status": "complete",
  "url": "https://example-store.com",
  "scannedAt": "2026-05-11T10:32:14.221Z",
  "pagesScanned": 4,
  "cms": "shopify",
  "scores": { "overall": 72, "accessibility": 81, "gpsr": 63 },
  "riskLevel": "medium",
  "issueCount": 14,
  "issues": [
    { "id": "img-missing-alt", "category": "accessibility",
      "severity": "high", "title": "Images missing alt text",
      "count": 12, "regulation": "EAA / WCAG 2.1" }
  ]
}

Get full scan result

Request

curl https://eurogpsr.com/api/v1/scans/sc_01HX... \
  -H "Authorization: Bearer egpsr_..."

Response (200 OK)

{
  "scanId": "sc_01HX...",
  "status": "complete",
  "meta": { "url": "...", "scannedAt": "...", "pagesScanned": 4, "cms": "shopify" },
  "scores": { ... },
  "issues": [ /* full issue list with details + fixGuide */ ]
}

List all checks and versions

Request

curl https://eurogpsr.com/api/v1/checks

Response (200 OK)

{
  "scannerVersion": "0.2.0",
  "checksUpdatedAt": "2026-04-22",
  "totalChecks": 22,
  "checks": [
    { "id": "img-missing-alt", "version": 3, "regulation": "EAA / WCAG 2.1",
      "category": "accessibility", "changelog": [ ... ] }
  ]
}