Headline counts, each with its definition
The numbers the igregulator.io homepage prints: licence records by status,
jurisdictions with their last register read and freshness, operators,
linked domains, brand pages, status changes read in the last 30 and 7 days
(with a few recent ones, each with its source page), withdrawn events and a
geo-check summary. Every value is a count of what the database holds at
generated_at; the body carries a definitions object saying exactly what
each one counts. Only active in licences.by_status means licensed now.
No key, no per-IP limit. Every caller gets the same payload, recounted at most every 10 minutes, so it is not metered: the homepage calls it on every view and a visit must not spend the visitor’s 10 lookups. A key sent with it is ignored — not checked, not charged — so this endpoint never answers 401, 402 or 429.
Per-jurisdiction last_read_at, age_hours, fresh and sla_hours follow
the same rule as /v1/health/coverage (24 h for UKGC, AN, TGC, IOM, ON, SE, ES, BE, DE, CO, UA; 48 h for MGA, CW, KH).
Responses
Section titled “ Responses ”Headline counts.
object
Licence records we hold from the regulators’ registers, in every status. by_status splits them by current status; only active means licensed now.
object
Licence records per current status. Every status is present (0 when none); surrendered and not_in_register are not revocations.
object
Count: regulators we hold at least one licence record for. items: every regulator we cover, with its licence records, how many are active, when we last read its register (the newest last_verified_at among its licences, as /v1/health/coverage reports it), and whether that read is inside its 24 h / 48 h freshness window.
object
Jurisdictions with at least one licence record.
Every jurisdiction we cover, ordered by code. One with no licence records yet has licences: 0 and nulls for the read.
object
Jurisdiction code — UKGC, MGA, CW (Curaçao), KH (Kahnawake), AN (Anjouan), TGC (Tobique), IOM (Isle of Man), ON (Ontario — the iGaming Ontario operator directory), SE (Sweden — online gaming and betting licences from the Spelinspektionen register, nothing else), ES (Spain — the DGOJ’s state-level online licences; not the state lotteries (SELAE, ONCE) or regional land-based gambling), BE (Belgium — the Gaming Commission’s online licence classes A+, B+ and F1+ only; not land-based licences or the Loterie Nationale), DE (Germany — the GGL whitelist’s four internet game types (virtual slots, online poker, sports betting, online horse betting); not a Land’s online casino permits, lotteries or land casinos), CO (Colombia — Coljuegos’ online gaming concessions only; not land-based gaming (juegos localizados) or the lotteries), UA (Ukraine — PlayCity’s online casino, online poker and bookmaking licences only; not land casinos or slot halls or the state lotteries). GET /v1/jurisdictions lists them with their names.
Licence records, any status.
Of those, licence records whose status is active.
When we last read this register: the newest last_verified_at among its licences (/v1/health/coverage’s last_successful_scrape).
Hours from last_read_at to generated_at, rounded to the nearest hour.
age_hours < sla_hours. A register we could not read keeps its last good read and turns false; null when never read.
Jurisdictions.items[].by_status: that regulator’s licence records by current status, with every status present (a zero is a count we made).
object
Operators holding at least one licence record, in any status, as each register names them — a company licensed by two regulators can be two operators.
object
Distinct domains with at least one active domain→operator link: a register or a regulator certificate lists the domain for that operator today.
Of those, domains with an active link that carries the regulator’s own per-domain certificate or seal page (Curaçao cert.cga.cw / cert.gcb.cw, Tobique validate.thetgc.ca) — the page /v1/check returns as verification_url.
Domains with a public page at app.igregulator.io/brands/
Licence status changes read from a regulator in the last 30 days: license_history events written by a scraper or the seal re-verifier, not since withdrawn, whose new status differs both from the previous one and from what the last event still standing had set — so a read that only puts a status back after a withdrawn event (the undo of the 2026-09-22 UKGC register flap) is not a change. First sightings, data-only updates and our correction/backfill migrations are excluded.
The same changes as status_changes_30d, over the last 7 days: total, and by_status = how many moved to each status.
object
How many of those changes moved a licence to each status.
object
Status_changes_7d.recent: up to six of those changes, newest first and at most one per regulator, each with the page it was read from. Only operators whose registered name carries a company legal form (Ltd, LLC, N.V., GmbH…) are listed, so no sole trader is named here; the counts include everyone.
object
Jurisdiction code — UKGC, MGA, CW (Curaçao), KH (Kahnawake), AN (Anjouan), TGC (Tobique), IOM (Isle of Man), ON (Ontario — the iGaming Ontario operator directory), SE (Sweden — online gaming and betting licences from the Spelinspektionen register, nothing else), ES (Spain — the DGOJ’s state-level online licences; not the state lotteries (SELAE, ONCE) or regional land-based gambling), BE (Belgium — the Gaming Commission’s online licence classes A+, B+ and F1+ only; not land-based licences or the Loterie Nationale), DE (Germany — the GGL whitelist’s four internet game types (virtual slots, online poker, sports betting, online horse betting); not a Land’s online casino permits, lotteries or land casinos), CO (Colombia — Coljuegos’ online gaming concessions only; not land-based gaming (juegos localizados) or the lotteries), UA (Ukraine — PlayCity’s online casino, online poker and bookmaking licences only; not land casinos or slot halls or the state lotteries). GET /v1/jurisdictions lists them with their names.
The operator as the register names it.
Its page: app.igregulator.io/operators/
The regulator page this change was read from.
License_history events we later withdrew as wrong (corrected_at set). They stay on the record with a correction note; none is deleted.
Geo-availability checks (Business plan): how many distinct domains we have fetched from inside at least one country, from which countries, and since when. An observation about what a visitor was served — never a licence status.
object
ISO country codes we have checked from.
The most recent register read across all jurisdictions (max of jurisdictions.items[].last_read_at). Individual registers can be older — see each item.
When these numbers were counted. The payload is cached for up to 10 minutes.
One sentence per number, saying what it counts — the same text as this schema. Keys: licences, jurisdictions, operators, domains_linked, domains_regulator_verified, brand_pages, status_changes_30d, corrections, jurisdiction_by_status, status_changes_7d, status_changes_recent, geo_checks, last_register_read_at, generated_at.
object
Headers
Section titled “ Headers ”Always public, max-age=300.
Always *: any page may read these numbers from the browser.
Unexpected server error. Safe to retry.
The body of every non-2xx response.
object
Human-readable summary. The wording can change; do not branch on it.
The error class. Mostly one per HTTP status, with two exceptions to know: quota_exceeded is a 429 for the monthly request quota and a 403 for a plan cap (watchlist size, webhook endpoints). A 409 carries conflict (it carried invalid_query before 1.24.0). Branch on the HTTP status and details.reason. forbidden is only ever sent to a signed-in MCP connection, never to an API key.
Always present. reason is always set; field and suggestion when they apply; limit errors add the numbers below.
object
Machine-readable refinement of the top-level code — branch on this. Values: invalid_input, missing_required_parameter, conflicting_parameters, not_a_valid_hostname, hostname_too_long, invalid_pagination, invalid_cursor, since_exceeds_retention_window, invalid_event_type, invalid_jurisdiction, as_of_not_supported, api_key_missing, malformed_header, api_key_invalid, api_key_revoked, plan_inactive, plan_ended, export_requires_pro, geo_checks_require_business, watchlist_quota_exceeded, webhook_quota_exceeded, operator_not_found, license_not_found, jurisdiction_not_found, webhook_not_found, dataset_not_found, route_not_found, method_not_allowed, watchlist_duplicate, no_active_secret, quota_exceeded, monthly_request_limit_reached, per_second_limit_exceeded, watchlist_events_poll_limit, export_daily_limit_reached, geo_check_quota_exceeded, internal_error. A rejected webhook URL carries the SSRF check’s reason (invalid_url, invalid_scheme, empty_host, blocked_hostname, unresolvable_host, private_ip_blocked). New values can be added.
Present only when the error maps to a specific request input (query param, path param, body key). Omitted for errors that aren’t field-scoped (e.g. rate_limited, auth_revoked).
A hint a person or an agent can act on. Present on every error today.
On a limit error (429, and the 403 plan caps): the ceiling that was reached.
On a keyed limit error: how much of limit is used. Not on the keyless per-IP 429 or the watchlist-poll 429.
When the counter starts again — on the keyless per-IP 429, the monthly quota, the watchlist-poll limit and the export daily limit. Not on the per-second limit (retry after one second).
The key’s plan, on plan-scoped limit errors and on export_requires_pro.
On export_requires_pro: the lowest plan that includes the feature.
On watchlist_events_poll_limit: always hour.
Example
{ "error": "Internal server error", "code": "server_error", "details": { "reason": "internal_error", "suggestion": "Retry with exponential backoff (1s / 2s / 4s). If the error persists past 4 seconds, surface failure state to the user instead of looping." }}