Issuer Monitoring

Monitor listed companies through filings, board changes, dividends, and issuer-scoped event feeds.

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 catalog:

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.

On this page