Disclosures

List receipt-linked disclosure records.

Fresh snapshot results use stable keyset pagination ordered by filed_date descending (nulls last), then first_observed_at and disclosure_id ascending. Existing pre-1.15 cursors retain first_observed_at/disclosure_id ascending; page.order names the order. Use as_of for point-in-time reconstruction and updated_since for incremental polling. Incremental pages echo page.requested_updated_since and contain both upserts and withdrawals, ordered oldest first. Consumers keep a map keyed by disclosure_id: an upsert replaces the current value; a supersede removes or marks the row withdrawn only when its version_id matches the version held locally. Continue through next_cursor before advancing the saved watermark to page.snapshot_as_of.

get/api/v1/disclosures

Request

  • Base URL: https://www.veridionmarkets.com
  • URL: https://www.veridionmarkets.com/api/v1/disclosures
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

document_idstring

Exact House numeric document ID or Senate eFD UUID (case-insensitive). Specify once; combines with other filters before pagination. Returns served lines only; held or missing lines are excluded. Unknown documents return an empty page.

Example:20035487
tickerstring

Ticker symbol, case-insensitive, for example NVDA.

member_idstring

Filer slug, for example nancy-pelosi.

person_idstring

Official Bioguide person identifier spanning linked tenures.

chamber'house' | 'senate' | 'executive'

Branch of government.

source_system'house_clerk' | 'senate_efd' | 'sec_edgar' | 'oge'

Originating government system.

filed_date_fromstring date

Earliest filing date, inclusive.

filed_date_tostring date

Latest filing date, inclusive.

transaction_type'buy' | 'sell' | 'exchange' | 'other'

Direction of the transaction.

transaction_date_fromstring date

Earliest transaction date, inclusive.

transaction_date_tostring date

Latest transaction date, inclusive.

min_delay_daysinteger

Only rows whose filing delay (filed_date minus transaction_date) is at least this many days. The STOCK Act window for periodic transaction reports is 45 days, so min_delay_days=46 returns filings outside it. Rows without a computed delay -- annual reports, and rows missing either date -- are excluded by this filter rather than guessed at.

within_statutory_windowboolean

true returns only rows filed inside the statutory window that applies to that row (statutory_window_days); false returns only rows filed outside it. Unlike min_delay_days, the boundary is each row's own window as served, not a number the caller supplies, so a client keeps working if the window ever differs by filing type or changes in law. Rows with no computed window -- annual reports -- are excluded by either value rather than guessed at. This filter selects on the 45-day transaction clock only. It is not a compliance filter: true does not mean the filing was timely, because the 30-day notification clock is not measured in this dataset.

limitinteger

Rows per page. Free requests are capped at 25; licensed requests are capped at 1000.

cursorstring

Opaque cursor from page.next_cursor. Omit to start again.

as_ofstring date-time

Only rows first observed at or before this instant. Must be on or after response.coverage.point_in_time_floor.

updated_sincestring date-time

Append-only change events observed strictly after this instant and no later than page.snapshot_as_of. Must be on or after response.coverage.point_in_time_floor. Includes upserts and supersessions.

Response

A page of disclosure records.

version'1.21.0' required
noticestring required

Changes

No recorded changes to this operation across all 1 revision of this API.