Developers

API & integrations

Run compliance scans from your own systems, from WordPress or straight from your browser. The API is included with Monitor and Agency plans.

Authentication

Create a key from your dashboard under API keys. The key is shown once, so store it safely. Send it as a bearer token on every request. Keys can be revoked at any time.

Authorization: Bearer cc_live_YOUR_KEY
  • Up to 5 active keys per account.
  • 500 URL scans per rolling 30 days. Scans of your own monitored sites don't count but have a 5-minute cooldown.
  • Rate limits: 30 scan requests and 300 API requests per 10 minutes per IP address.
  • Responses are JSON. Errors return {"error": "..."} with a 4xx or 5xx status.

Endpoints

GET/api/v1/sites

Lists your monitored sites with the latest scan score and a report link.

curl https://dmg-compliancecheck.com/api/v1/sites \
  -H "Authorization: Bearer cc_live_YOUR_KEY"
GET/api/v1/scans/{id}

Returns one of your scans with category scores and every issue found.

curl https://dmg-compliancecheck.com/api/v1/scans/SCAN_ID \
  -H "Authorization: Bearer cc_live_YOUR_KEY"
POST/api/v1/scan

Runs a scan. Send {"url"} for a homepage scan of any public site, or {"siteId"} for a full crawl of one of your monitored sites.

curl -X POST https://dmg-compliancecheck.com/api/v1/scan \
  -H "Authorization: Bearer cc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.co.uk"}'

Release gate (CI/CD)

POST/api/v1/ci

Scan your site after every deploy and fail the pipeline if compliance slips. Send siteId (crawls up to 25 pages of a monitored site) or url (homepage), plus your rules: minScore (default 70), maxCritical and failOnNewScripts (fails when a third-party script appears that was not in the previous scan). The response is always HTTP 200 with pass, score, reasons, newScripts and reportUrl. Up to 1,000 gate runs per rolling 30 days.

curl -X POST https://dmg-compliancecheck.com/api/v1/ci \
  -H "Authorization: Bearer cc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"siteId":"SITE_ID","minScore":75,"maxCritical":0,"failOnNewScripts":true}'

GitHub Actions

Add your API key as the repository secret COMPLIANCECHECK_KEY, then add this job after your deploy step.

compliance:
  runs-on: ubuntu-latest
  needs: deploy
  steps:
    - name: ComplianceCheck release gate
      env:
        CC_KEY: ${{ secrets.COMPLIANCECHECK_KEY }}
      run: |
        RES=$(curl -sS -X POST https://dmg-compliancecheck.com/api/v1/ci \
          -H "Authorization: Bearer $CC_KEY" -H "Content-Type: application/json" \
          -d '{"siteId":"SITE_ID","minScore":75,"failOnNewScripts":true}')
        echo "$RES"
        echo "$RES" | jq -e '.pass == true' > /dev/null || { echo "::error::Compliance gate failed"; exit 1; }

Webhooks

Receive signed events (scan completed, score dropped, scripts changed, SSL or domain expiring, new lead, data-rights request) in Zapier, Make or your own endpoint. Set it up on the Integrations page. Each request carries an X-ComplianceCheck-Signature header (HMAC-SHA256) so you can check it came from us.

Plugins

Plugins

WordPress plugin

Shows your latest compliance score in the WordPress admin and lets you start a scan.

  1. Download the zip.
  2. In WordPress go to Plugins → Add New → Upload Plugin.
  3. Activate it, then open Settings → ComplianceCheck and paste your API key.
Download plugin

Chrome extension

Scan the website in your current tab with one click and open the full report.

  1. Download and unzip the extension.
  2. Open chrome://extensions and turn on Developer mode.
  3. Click Load unpacked, choose the folder, then add your API key in the popup.
Download extension