Skip to content
iGregulator docs

Overview

iGregulator API 1.35.0

Section titled “ iGregulator API 1.35.0 ”

REST API for gambling-licence verification: domain → operator → licence → status, read daily from fourteen regulator registers (UKGC, MGA, CW, KH, AN, TGC, IOM, ON, SE, ES, BE, DE, CO, UA). Every status carries the regulator page that published it and when we last read it there. A licence a register stops listing is reported as not_in_register — an observation, never “revoked”; and a domain we do not find is “not in the registers we cover”, never “unlicensed”.

Legal notice. Information returned by this API is sourced from public gambling-regulator registers and is provided for informational purposes only. Results do not constitute legal advice or regulatory guidance. Customers are responsible for their own compliance, KYB, and AML decisions and should confirm critical licensing decisions against the issuing regulator. Full terms at https://igregulator.io/terms/; coverage methodology at https://igregulator.io/docs/coverage-methodology/.

Six endpoints work without a key: /v1/check, /v1/operators/search, /v1/jurisdictions and /v1/health/coverage (10 requests per IP per hour, counted per endpoint), plus /v1/stats and /v1/health (not limited). Every other endpoint needs an API key and is limited by its plan — see https://igregulator.io/docs/rate-limits/.

Authentication is Authorization: Bearer <key> — create an account at https://app.igregulator.io/signup, start a plan (Starter: the first 14 days are free, card required) and generate a key at https://app.igregulator.io/api-keys.

Every error has the same body — { error, code, details: { reason, … } } (the ApiError schema); an unknown /v1/* path is a 404 with details.reason: route_not_found.

Information

Operations

Section titled “ Operations ”
GET
/v1/check
POST
/v1/check/batch
GET
/v1/jurisdictions
GET
/v1/jurisdictions/{code}
GET
/v1/jurisdictions/{code}/operators
GET
/v1/operators/search
GET
/v1/operators/{slug}
GET
/v1/operators/{slug}/licenses
GET
/v1/operators/{slug}/regulatory-actions
GET
/v1/licenses/{license_id}
GET
/v1/licenses/{license_id}/history
GET
/v1/geo-checks
POST
/v1/geo-checks
GET
/v1/geo-check-requests
GET
/v1/watchlist
GET
/v1/watchlist/operators
POST
/v1/watchlist/operators
DELETE
/v1/watchlist/operators/{slug}
GET
/v1/watchlist/events
GET
/v1/webhooks
POST
/v1/webhooks
DELETE
/v1/webhooks/{id}
PATCH
/v1/webhooks/{id}
POST
/v1/webhooks/{id}/rotate_secret
GET
/v1/webhooks/{id}/deliveries
POST
/v1/webhooks/{id}/test
GET
/v1/export/{dataset}
GET
/v1/health
GET
/v1/health/coverage
GET
/v1/stats

Authentication

Section titled “ Authentication ”

bearerAuth

Section titled “ bearerAuth ”

An API key created at https://app.igregulator.io/api-keys (on a plan: Starter’s first 14 days are free, card required), sent as Authorization: Bearer <key>.

Limits are per account, by plan: Starter 10,000 requests / month and 5 / second; Pro 100,000 / month and 20 / second; Business no monthly quota, 100 / second. A larger plan is bought at https://app.igregulator.io/billing (by card, or by invoice for three months or more), or email founder@igregulator.io if you need a higher limit. A request that ends in an error (4xx / 5xx) is not counted against the monthly quota. See https://igregulator.io/docs/rate-limits/.

Security scheme type: http