Skip to content

Headline counts, each with its definition

GET
/v1/stats

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).

Headline counts.

Media type application/json
object
licences
required

Licence records we hold from the regulators’ registers, in every status. by_status splits them by current status; only active means licensed now.

object
total
required
integer
by_status
required

Licence records per current status. Every status is present (0 when none); surrendered and not_in_register are not revocations.

object
active
required
integer
suspended
required
integer
revoked
required
integer
expired
required
integer
pending
required
integer
unknown
required
integer
surrendered
required
integer
not_in_register
required
integer
key
additional properties
integer
jurisdictions
required

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
count
required

Jurisdictions with at least one licence record.

integer
items
required

Every jurisdiction we cover, ordered by code. One with no licence records yet has licences: 0 and nulls for the read.

Array<object>
object
code
required

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.

string
name
required
string
licences
required

Licence records, any status.

integer
active
required

Of those, licence records whose status is active.

integer
last_read_at
required

When we last read this register: the newest last_verified_at among its licences (/v1/health/coverage’s last_successful_scrape).

string | null format: date-time
age_hours
required

Hours from last_read_at to generated_at, rounded to the nearest hour.

integer | null
fresh
required

age_hours < sla_hours. A register we could not read keeps its last good read and turns false; null when never read.

boolean | null
sla_hours
required
integer
Allowed values: 24 48
by_status
required

Jurisdictions.items[].by_status: that regulator’s licence records by current status, with every status present (a zero is a count we made).

object
active
required
integer
suspended
required
integer
revoked
required
integer
expired
required
integer
pending
required
integer
unknown
required
integer
surrendered
required
integer
not_in_register
required
integer
key
additional properties
integer
operators
required

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.

integer
domains
required
object
linked
required

Distinct domains with at least one active domain→operator link: a register or a regulator certificate lists the domain for that operator today.

integer
regulator_verified
required

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.

integer
brand_pages
required

Domains with a public page at app.igregulator.io/brands/ — the /brands directory total: an active link, a hostname (not a URL with a path), not a subdomain of another live domain of the same operator, and not the www. spelling of a host that is itself listed (one page per site).

integer
status_changes_30d
required

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.

integer
status_changes_7d
required

The same changes as status_changes_30d, over the last 7 days: total, and by_status = how many moved to each status.

object
total
required
integer
by_status
required

How many of those changes moved a licence to each status.

object
active
required
integer
suspended
required
integer
revoked
required
integer
expired
required
integer
pending
required
integer
unknown
required
integer
surrendered
required
integer
not_in_register
required
integer
key
additional properties
integer
recent
required

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.

Array<object>
<= 6 items
object
changed_at
required
string format: date-time
jurisdiction
required

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.

string
operator
required

The operator as the register names it.

string
operator_slug
required

Its page: app.igregulator.io/operators/.

string | null
previous_status
required
string
new_status
required
string
source_url
required

The regulator page this change was read from.

string | null
corrections
required

License_history events we later withdrew as wrong (corrected_at set). They stay on the record with a correction note; none is deleted.

integer
geo_checks
required

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
domains
required
integer
countries
required

ISO country codes we have checked from.

Array<string>
since
required
string | null format: date-time
last_register_read_at
required

The most recent register read across all jurisdictions (max of jurisdictions.items[].last_read_at). Individual registers can be older — see each item.

string | null format: date-time
generated_at
required

When these numbers were counted. The payload is cached for up to 10 minutes.

string format: date-time
definitions
required

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
key
additional properties
string
Cache-Control
string

Always public, max-age=300.

Access-Control-Allow-Origin
string

Always *: any page may read these numbers from the browser.

Unexpected server error. Safe to retry.

Media type application/json

The body of every non-2xx response.

object
error
required

Human-readable summary. The wording can change; do not branch on it.

string
code
required

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.

string
Allowed values: invalid_query invalid_slug invalid_license_id invalid_jurisdiction_code invalid_pagination auth_required auth_invalid auth_revoked payment_required forbidden not_found method_not_allowed conflict quota_exceeded rate_limited server_error
details
required

Always present. reason is always set; field and suggestion when they apply; limit errors add the numbers below.

object
reason
required

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.

string
field

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).

string
suggestion

A hint a person or an agent can act on. Present on every error today.

string
limit

On a limit error (429, and the 403 plan caps): the ceiling that was reached.

integer
current_usage

On a keyed limit error: how much of limit is used. Not on the keyless per-IP 429 or the watchlist-poll 429.

integer
reset_at

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).

string format: date-time
plan_tier

The key’s plan, on plan-scoped limit errors and on export_requires_pro.

string
required_plan

On export_requires_pro: the lowest plan that includes the feature.

string
window

On watchlist_events_poll_limit: always hour.

string
key
additional properties
any

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."
}
}