Issuer Monitoring

Use this workflow when you need to:

track filings for a watchlist of companies
surface dividend and board-change signals
route issuer events into internal review workflows
load company history and receive new events for tracked issuers

What Rangler gives you

The issuer workflow package is built from:

GET /v1/companies
GET /v1/companies/{company_id}
GET /v1/companies/{company_id}/filings
GET /v1/companies/{company_id}/events
GET /v1/events?type=filing.new&type=board_change.detected&type=dividend.declared
webhook subscriptions filtered by issuer event type and company scope

In the portal, the matching preset is Issuer monitoring.

Start with webhooks

Start with webhooks when issuer updates should drive a customer-facing product, alert, or internal review workflow.

Company watchlist sync

Fetch the current company directory:

curl -s "https://sandbox-api.rangler.co/v1/companies?limit=100" \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

Use the company IDs in your own watchlist table.

Filings for one issuer

curl -s "https://sandbox-api.rangler.co/v1/companies/{company_id}/filings?limit=25" \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

Check issuer events for missed deliveries

curl -s "https://sandbox-api.rangler.co/v1/events?type=filing.new&type=board_change.detected&type=dividend.declared&limit=25" \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

Or narrow to one company:

curl -s "https://sandbox-api.rangler.co/v1/companies/{company_id}/events?limit=25" \
  -H "X-API-Key: rgl_test_your_key_here" | python3 -m json.tool

With ranglerpy:

from ranglerpy import RanglerClient

client = RanglerClient(api_key="rgl_test_your_key_here", environment="sandbox")

for event in client.v1.events.auto_paging_iter(
    event_types=["filing.new", "board_change.detected", "dividend.declared"],
    limit=100,
):
    print(event.type, event.company_id, event.title)

Recommended rule

In the portal:

Create a webhook endpoint
Choose the Issuer monitoring preset
Keep event types:
- filing.new
- board_change.detected
- dividend.declared
Add company IDs for your tracked issuer set
Leave fund IDs empty

Partner payload pattern

Receiver flow:

receive a matched issuer event
verify the webhook signature
use company_id, source_kind, source_id, and source_url to record where the event came from
fetch richer company or filing detail through the API if needed
fan the event out to your own alerting or internal review systems

See Webhooks for delivery rules and Events for the event format.

Example issuer webhook payload

{
  "id": "6f1a36c1-d7b7-4700-a2e5-6fd1ac9f2748",
  "type": "filing.new",
  "occurred_at": "2026-04-12T10:00:00Z",
  "created_at": "2026-04-12T10:00:00.412991Z",
  "entity_kind": "filing",
  "entity_id": "3bff7f59-8e0d-4105-a4c5-9f2a12c98b2c",
  "company_id": "b2f9ed97-3036-4f08-b6b0-b2a8265f93f4",
  "fund_id": null,
  "source_kind": "filing",
  "source_id": "3bff7f59-8e0d-4105-a4c5-9f2a12c98b2c",
  "title": "Issuer Plc FY 2025 Results",
  "summary": "New results filing published.",
  "severity": "info",
  "source_url": "https://example.com/issuer-results.pdf",
  "source_published_at": "2026-04-12T09:58:00Z",
  "data": {
    "company": {
      "id": "b2f9ed97-3036-4f08-b6b0-b2a8265f93f4",
      "name": "Issuer Plc",
      "ticker": "ISSUER",
      "sector": "Financial Services",
      "logo_url": null
    },
    "filing": {
      "id": "3bff7f59-8e0d-4105-a4c5-9f2a12c98b2c",
      "company_id": "b2f9ed97-3036-4f08-b6b0-b2a8265f93f4",
      "filing_type": "results",
      "title": "Issuer Plc FY 2025 Results",
      "period": "FY 2025",
      "published_at": "2026-04-12T09:58:00Z",
      "url": "https://example.com/issuer-results.pdf",
      "has_tables": false
    }
  }
}

Source-backed event detail

Rangler activity and delivery views show source fields including:

source_kind
source_id
source_url
source_published_at

Use those fields when your workflow needs a source-backed audit trail.

Recommended first production path

For most teams:

sync company IDs through API reads
register a webhook endpoint and issuer-monitoring subscription
read event feeds periodically to catch missed deliveries and load earlier records

See Webhooks and Event Feeds and Sandbox Testing before you move from sandbox to live.

Overview

Getting started

Workflows

Financial data

Integration

Reference

What Rangler gives you

Start with webhooks

Company watchlist sync

Filings for one issuer

Check issuer events for missed deliveries

Recommended rule

Partner payload pattern

Example issuer webhook payload

Source-backed event detail

Recommended first production path

​What Rangler gives you

​Start with webhooks

​Company watchlist sync

​Filings for one issuer

​Check issuer events for missed deliveries

​Recommended rule

​Partner payload pattern

​Example issuer webhook payload

​Source-backed event detail

​Recommended first production path

What Rangler gives you

Start with webhooks

Company watchlist sync

Filings for one issuer

Check issuer events for missed deliveries

Recommended rule

Partner payload pattern

Example issuer webhook payload

Source-backed event detail

Recommended first production path