> ## Documentation Index > Fetch the complete documentation index at: https://docs.rangler.co/llms.txt > Use this file to discover all available pages before exploring further. # Events > Understand Rangler event types and the payload format used by webhooks and event feeds. Rangler exposes events through webhook deliveries and authenticated event-feed reads. Event data appears in: * `GET /v1/events` * `GET /v1/companies/{company_id}/events` * `GET /v1/funds/{fund_id}/events` * webhook `POST` deliveries `webhook.test` is only used for manual webhook validation. It is **not** part of the event-feed contract and does not appear in `/v1/events`, company event feeds, or fund event feeds. ## Event format Every Rangler event includes: * `id` * `type` * `occurred_at` * `created_at` * `entity_kind` * `entity_id` * `company_id` * `fund_id` * `source_kind` * `source_id` * `title` * `summary` * `severity` * `source_url` * `source_published_at` * `data` ## Versioning Rangler versions the event contract through `/v1/events` and the documented webhook contract. Rangler does **not** include a top-level `event_version` field. * new optional fields may appear over time without a payload-version change * changes that would break existing integrations will use an explicit API or webhook version change * event feeds and webhook deliveries stay compatible within the current API version ## Timestamp semantics Rangler exposes three top-level timestamps: * `occurred_at`: the timestamp Rangler uses to order feed results and continue from one page to the next * `created_at`: when Rangler persisted the event record internally * `source_published_at`: when the upstream filing, factsheet, or source page was published, if Rangler knows it Event-specific `occurred_at` semantics are: * `filing.new`: the filing `published_at` * `filing.signal.created`: the Rangler extraction/promotion time for the structured signal * `board_change.detected`: the Rangler extraction/promotion time for the structured board-change signal * `dividend.declared`: the Rangler extraction/promotion time for the structured dividend signal * `fund.snapshot.updated`: `source_published_at` when known, otherwise the snapshot `as_of_date` at `00:00:00Z` * `fund.disclosure.updated`: `source_published_at` when known, otherwise the snapshot `as_of_date` at `00:00:00Z` * company meeting and stream lifecycle events: the scheduled time or observed stream transition time represented by the source workflow Rangler does **not** yet expose a stable top-level `effective_at` field. For dividends and other corporate actions, use the event-specific `data` payload and source document until Rangler provides a consistent top-level `effective_at`. Rangler also provides two top-level fields that identify the source: * `source_kind`: the type of source Rangler used, such as `filing`, `filing_signal`, `portfolio_fund_snapshot`, or `sandbox_event` * `source_id`: the Rangler ID for that source record ## Supported event types | Event type | Trigger | `data` payload | | - | - | - | | `filing.new` | New filing inserted into Rangler | `company`, `filing` | | `filing.signal.created` | Filing first receives a promoted signal | `company`, `filing`, `signal` | | `financials.published` | Financial results are identified in a filing | `company`, `filing`, `signal` | | `board_meeting.notice` | A board-meeting notice is identified | `company`, `filing`, `signal` | | `board_change.detected` | Structured board-change details are first available for a filing | `company`, `filing`, `signal` | | `dividend.declared` | Structured dividend details are first available for a filing | `company`, `filing`, `signal` | | `rights.issue.announced` | A rights issue is identified in a filing | `company`, `filing`, `signal` | | `bonus.issue.announced` | A bonus issue is identified in a filing | `company`, `filing`, `signal` | | `director_dealing.disclosed` | A director dealing is identified in a filing | `company`, `filing`, `signal` | | `company.meeting.scheduled` | A company meeting is scheduled | company and meeting context | | `company.meeting.stream.scheduled` | A meeting stream is scheduled | company and stream context | | `company.meeting.stream.live` | A monitored meeting stream becomes live | company and stream context | | `company.meeting.stream.ended` | A monitored meeting stream ends | company and stream context | | `company.meeting.stream.replay_available` | A meeting replay becomes available | company and stream context | | `fund.snapshot.updated` | New fund snapshot is created | `fund`, `snapshot`, `disclosure_kind` | | `fund.disclosure.updated` | New fund snapshot includes disclosure content | `fund`, `snapshot`, `disclosure_kind` | ## Connect event types Connect operational subscriptions use a separate organization-scoped contract: * `connect.connection.created` * `connect.connection.updated` * `connect.connection.revoked` * `connect.sync.completed` * `connect.sync.failed` * `connect.item.login_required` Configure Connect event subscriptions through the portal API. They use the same webhook endpoints and signing rules as market events. ## Feed behavior The unified event feed is ordered by: 1. `occurred_at` descending 2. `id` descending Filtering supports: * repeated `type` parameters * `company_id` * `fund_id` * `from` * `to` * `limit` Use `cursor` to load earlier records and check for events your system may have missed. Examples: * `GET /v1/events?type=dividend.declared` * `GET /v1/events?type=filing.new&type=board_change.detected` ## Example payloads ```json theme={null} { "id": "2d0f3ed8-71e3-4d9c-a61a-5ddd84d020b6", "type": "filing.new", "occurred_at": "2026-04-11T01:05:18.383263Z", "created_at": "2026-04-11T01:05:19.012411Z", "entity_kind": "filing", "entity_id": "0f9df103-7873-4bd1-be96-9379fcaae66b", "company_id": "24b76421-51db-45ea-ba65-8c84eface2ea", "fund_id": null, "source_kind": "filing", "source_id": "0f9df103-7873-4bd1-be96-9379fcaae66b", "title": "Rangler Bank FY 2025 Results", "summary": "New results filing published.", "severity": "info", "source_url": "https://example.com/rangler-live-f49dbc18.pdf", "source_published_at": "2026-04-11T01:05:18.381927Z", "data": { "company": { "id": "24b76421-51db-45ea-ba65-8c84eface2ea", "name": "Rangler Live Bank f49dbc18", "ticker": "AF49DB", "sector": "Financial Services", "logo_url": null }, "filing": { "id": "0f9df103-7873-4bd1-be96-9379fcaae66b", "company_id": "24b76421-51db-45ea-ba65-8c84eface2ea", "filing_type": "results", "title": "Rangler Bank FY 2025 Results", "period": "FY 2025", "published_at": "2026-04-11T01:05:18.381927+00:00", "url": "https://example.com/rangler-live-f49dbc18.pdf", "has_tables": false, "company": { "id": "24b76421-51db-45ea-ba65-8c84eface2ea", "name": "Rangler Live Bank f49dbc18", "ticker": "AF49DB", "sector": "Financial Services", "logo_url": null } } } } ``` ```json theme={null} { "id": "5f9af65d-4932-42c8-a1cf-9732d2e5f102", "type": "filing.signal.created", "occurred_at": "2026-04-11T01:08:54.191211Z", "created_at": "2026-04-11T01:08:54.482992Z", "entity_kind": "filing", "entity_id": "0f9df103-7873-4bd1-be96-9379fcaae66b", "company_id": "24b76421-51db-45ea-ba65-8c84eface2ea", "fund_id": null, "source_kind": "filing_signal", "source_id": "1fe57130-3ef6-4b15-a950-63504c6bce5a", "title": "Rangler Bank FY 2025 Results signal extracted", "summary": "Revenue grew year over year and profit before tax improved.", "severity": "info", "source_url": "https://example.com/rangler-live-f49dbc18.pdf", "source_published_at": "2026-04-11T01:05:18.381927Z", "data": { "company": { "id": "24b76421-51db-45ea-ba65-8c84eface2ea", "name": "Rangler Live Bank f49dbc18", "ticker": "AF49DB", "sector": "Financial Services", "logo_url": null }, "filing": { "id": "0f9df103-7873-4bd1-be96-9379fcaae66b", "company_id": "24b76421-51db-45ea-ba65-8c84eface2ea", "filing_type": "results", "title": "Rangler Bank FY 2025 Results", "period": "FY 2025", "published_at": "2026-04-11T01:05:18.381927+00:00", "url": "https://example.com/rangler-live-f49dbc18.pdf", "has_tables": false }, "signal": { "extraction_id": "1fe57130-3ef6-4b15-a950-63504c6bce5a", "summary": "Revenue grew year over year and profit before tax improved.", "confidence": 0.94, "extracted_at": "2026-04-11T01:08:54.191211+00:00", "reporting_period": "FY 2025", "key_points": [ "Revenue growth improved year over year", "Profit before tax increased" ], "mentioned_tickers": [ "AF49DB" ], "dates_mentioned": [ "2025-12-31" ], "risk_flags": [], "corporate_actions": [], "board_changes": [], "metrics": [], "result_details": { "headline": "FY 2025 results" }, "corporate_action_details": [], "board_change_details": [], "highlights": [ "Improved profitability" ] } } } ``` ```json theme={null} { "id": "87f628f4-0497-41c7-a9af-8ab8adba0c89", "type": "board_change.detected", "occurred_at": "2026-04-10T10:04:11Z", "created_at": "2026-04-10T10:04:11.441992Z", "entity_kind": "filing", "entity_id": "filing_123", "company_id": "company_123", "fund_id": null, "source_kind": "filing_signal", "source_id": "signal_board_123", "title": "Board changes detected", "summary": "Issuer appointed a new independent director and accepted one resignation.", "severity": "medium", "source_url": "https://example.com/issuer-board-change.pdf", "source_published_at": "2026-04-10T10:00:00Z", "data": { "company": { "id": "company_123", "name": "Issuer Plc", "ticker": "ISSUER" }, "filing": { "id": "filing_123", "filing_type": "board_change", "published_at": "2026-04-10T10:00:00Z", "url": "https://example.com/issuer-board-change.pdf" }, "signal": { "summary": "Issuer appointed a new independent director and accepted one resignation.", "board_changes": [ "Appointment of Jane Doe as Independent Non-Executive Director", "Resignation of John Roe as Executive Director" ], "highlights": [ "Independent director appointment", "Executive resignation" ] } } } ``` ```json theme={null} { "id": "b6e820d7-7284-4908-b5fc-c7ae77f01c69", "type": "dividend.declared", "occurred_at": "2026-04-10T10:06:33Z", "created_at": "2026-04-10T10:06:33.172000Z", "entity_kind": "filing", "entity_id": "filing_456", "company_id": "company_456", "fund_id": null, "source_kind": "filing_signal", "source_id": "signal_dividend_456", "title": "Dividend declared", "summary": "Dividend Plc proposed a final cash dividend for FY 2025.", "severity": "medium", "source_url": "https://example.com/dividend-plc-action.pdf", "source_published_at": "2026-04-10T10:00:00Z", "data": { "company": { "id": "company_456", "name": "Dividend Plc", "ticker": "DVDND" }, "filing": { "id": "filing_456", "filing_type": "corporate_action", "published_at": "2026-04-10T10:00:00Z", "url": "https://example.com/dividend-plc-action.pdf" }, "signal": { "summary": "Dividend Plc proposed a final cash dividend for FY 2025.", "corporate_actions": [ "Final cash dividend proposed" ], "highlights": [ "Cash dividend declaration" ] } } } ``` ```json theme={null} { "id": "d42700c5-00da-4fe2-91c6-9175085d0213", "type": "fund.snapshot.updated", "occurred_at": "2026-04-09T09:00:00Z", "created_at": "2026-04-09T09:00:01.201922Z", "entity_kind": "fund", "entity_id": "fund_789", "company_id": null, "fund_id": "fund_789", "source_kind": "portfolio_fund_snapshot", "source_id": "snapshot_789", "title": "Rangler Income Fund snapshot updated", "summary": "New fund snapshot recorded for Rangler Income Fund.", "severity": "info", "source_url": "https://example.com/rangler-income-fund-april-2026.pdf", "source_published_at": "2026-04-09T09:00:00Z", "data": { "fund": { "id": "fund_789", "provider": "rangler_am", "slug": "rangler-income-fund", "name": "Rangler Income Fund" }, "snapshot": { "id": "snapshot_789", "fund_id": "fund_789", "as_of_date": "2026-04-09", "factsheet_title": "Rangler Income Fund April 2026 Factsheet", "factsheet_url": "https://example.com/rangler-income-fund-april-2026.pdf", "source_post_url": "https://example.com/rangler-income-fund", "source_published_at": "2026-04-09T09:00:00+00:00", "source_metrics": { "current_asset_allocation": [ { "label": "Cash", "weight_pct": 30.0 } ] }, "top_holdings": null, "disclosure_kind": "asset_allocation" }, "disclosure_kind": "asset_allocation" } } ``` ```json theme={null} { "id": "9a47018e-64f2-4712-875e-c1b8cc4fa901", "type": "fund.disclosure.updated", "occurred_at": "2026-04-09T09:00:00Z", "created_at": "2026-04-09T09:00:01.612113Z", "entity_kind": "fund", "entity_id": "fund_789", "company_id": null, "fund_id": "fund_789", "source_kind": "portfolio_fund_snapshot", "source_id": "snapshot_789", "title": "Rangler Income Fund April 2026 Factsheet", "summary": "Fund disclosure updated with a new factsheet snapshot.", "severity": "info", "source_url": "https://example.com/rangler-income-fund-april-2026.pdf", "source_published_at": "2026-04-09T09:00:00Z", "data": { "fund": { "id": "fund_789", "provider": "rangler_am", "slug": "rangler-income-fund", "name": "Rangler Income Fund" }, "snapshot": { "id": "snapshot_789", "fund_id": "fund_789", "as_of_date": "2026-04-09", "factsheet_title": "Rangler Income Fund April 2026 Factsheet", "factsheet_url": "https://example.com/rangler-income-fund-april-2026.pdf", "source_post_url": "https://example.com/rangler-income-fund", "source_published_at": "2026-04-09T09:00:00+00:00", "source_metrics": { "current_asset_allocation": [ { "label": "Cash", "weight_pct": 30.0 } ] }, "top_holdings": null, "disclosure_kind": "asset_allocation" }, "disclosure_kind": "asset_allocation" } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.