Authentication
All API requests must include an Authorization header with a Bearer token. Tokens are generated in Account Settings, API Keys. API tokens are scoped to your organization and do not expire unless revoked.
Authorization: Bearer rgl_live_k9f2a3b...Rate limit: 200 requests per minute per token. Exceeding the limit returns HTTP 429. Rate limit headers are included in all responses.
GET /v1/alerts
Returns a paginated list of alerts generated by the mapping engine. Alerts represent a detected regulatory change matched to one or more controls in your library.
Query parameters
| Parameter | Type | Description |
|---|---|---|
since | ISO 8601 | Return alerts detected after this timestamp |
status | string | unreviewed, accepted, overridden |
control_category | string | Filter by control category label |
source | string | Filter by regulatory source (e.g. FinCEN) |
limit | integer | Max 100. Default 20 |
cursor | string | Pagination cursor from previous response |
{
"alerts": [
{
"id": "alrt_7f2a39",
"source": "FinCEN",
"regulation": "31 CFR 1010.306",
"control_id": "BSA-CTR-007",
"confidence": 0.94,
"detected_at": "2026-05-12T09:14:00Z",
"status": "unreviewed"
}
],
"total": 47,
"next_cursor": "cursor_abc123"
}GET /v1/controls
Returns all controls in your library. Supports filtering by category. Useful for syncing your Regloom control library with an external GRC system.
{
"controls": [
{
"id": "ctrl_b12x99",
"control_id": "BSA-CTR-007",
"description": "Currency Transaction Report thresholds",
"category": "BSA",
"owner_email": "[email protected]",
"alert_count": 3
}
],
"total": 214
}GET /v1/sources
Returns all available regulatory sources, including which ones are enabled for your organization.
{
"sources": [
{
"id": "src_fincen",
"name": "FinCEN",
"type": "federal",
"enabled": true,
"last_checked": "2026-06-04T06:00:00Z"
}
]
}GET /v1/changes
Returns raw regulatory change records detected by Regloom, independent of whether they mapped to any control in your library.
{
"changes": [
{
"id": "chg_a9f2c1",
"source": "CFPB",
"title": "CFPB Issues Final Rule on Section 1071",
"detected_at": "2026-06-01T11:30:00Z",
"mapped_to_controls": ["SBLR-DATA-001", "SBLR-REPORT-003"]
}
]
}