ConsentGuard.io now has an API.
If you're an agency that already automates parts of client onboarding, or runs periodic audits on clients' GA4 and Google Ads accounts, monitoring Consent Mode can slot right into those flows. If you're a developer who wants compliance checks wired into your deployment pipeline, that's covered too. Either way, you no longer have to click through the dashboard one site at a time.
Full reference docs are at /docs/api. Here's the short version.
What you can do with it
The API covers the same things you'd do in the dashboard, just programmatically:
- Run a spot check on any URL.
POST /api/v1/spot-checkqueues a one-off validation and returns a request UUID. - Manage a list of websites.
POST /api/v1/websitesadds a site to your managed list (which gets a daily check),DELETE /api/v1/websites/{id}removes it. - List your checks.
GET /api/v1/checksreturns a paginated list of every check you've run, both spot and scheduled. - Fetch results.
GET /api/v1/results/{uuid}returns the validation report when it's done, including violations, severity, recommendations, and the compliance score.
Authentication is a bearer token. Generate one in your dashboard under Integrations > API Tokens and pass it as Authorization: Bearer YOUR_API_TOKEN.
Webhooks for instant notifications
Polling the results endpoint every few seconds works, but it's not what you want in production. Subscribe to a webhook instead and we'll push the result to your endpoint as soon as a check finishes.
Two events are available:
validation.completed— fires when a check finishes successfully.validation.failed— fires when a check couldn't be completed.
You can configure webhook endpoints in the same Integrations area of your dashboard.
Who this is for
A few patterns we built this with in mind:
Agencies with an automated client onboarding flow. A lot of agencies already provision tracking, analytics, and dashboards automatically when a new client comes on board. ConsentGuard slots into that same flow: when a client is created in your system, hit POST /websites to register their site, and consent monitoring is live from day one. No extra manual step, no client falling through the cracks.
Agencies managing an existing portfolio. Pull every site under management into a single internal dashboard, or run a sweep across the whole portfolio whenever Google or a CMP vendor changes something on their side.
Agencies running automated client audits. A lot of agencies already have an automated audit process for clients' GA4 or Google Ads accounts, looking at bid configs, conversion tagging, attribution, and the rest. Add one API call to that pipeline and the Consent Mode side of the picture is covered too. A spot check returns the same compliance score, violations, and recommendations you'd see in the dashboard, ready to roll into your audit deliverable.
Developers and DevOps teams. Trigger a spot check from CI after a tag deploy, fail the build if a critical violation appears, and post the report to Slack via the webhook. Catching a broken Consent Mode setup at deploy time is much cheaper than catching it a week later in the analytics report.
Anyone with a custom workflow. The endpoints are deliberately small and predictable. If you want to build something on top of them, you can.
Getting started
- Sign in and head to Integrations > API Tokens to generate a token.
- Hit
GET /api/v1/checkswith that token to confirm everything works. - Read the full API reference for the request and response shapes.
A note on limits: API access respects your plan's domain limit and rate limits. Agency plans give you the headroom to actually use it across a portfolio. See pricing for the details.
Final thoughts
This is the first version. The endpoints cover the workflows we've seen most often in conversations with early users, but there's plenty more we could expose. If something you'd want to automate isn't there yet, tell us and we'll prioritise based on what people actually ask for.
— Mihai Cofounder, ConsentGuard.io