Docs
PricingSupportSign Up

/screener/events

Screen corporate event filings by company, filing date and Item code. Returns matching section summaries grouped by filing. Requires Pro or higher.

POST/api/v1/screener/events
Rate limit10 per minute

Request:

tickersstring[]

1–100 symbols, each 1–32 characters. Case-insensitive; duplicates removed. Omitted = all available companies.

Default omitted

start_date, end_dateISO date

Inclusive bounds on filing_date; start_date ≤ end_date. Either bound may be omitted.

Default omitted

as_of_dateISO date

Exclude filings filed after this date: an end_date with no start. Must not be in the future or earlier than start_date.

Default omitted

itemsstring[]

1–33 codes from GET /events/types; duplicates removed. Omitted = all Items.

Default omitted

item_match"any" | "all"

Match at least one or all requested Item codes in a filing. Applies only when items is supplied.

Default "any"

include_unresolved_amendmentsbool

Include standalone amendments without an associated original filing.

Default false

exclude_likely_mergedbool

Exclude filings with merge_status="likely".

Default false

pageint ≥ 1

Default 1

page_sizeint 1–10

Filings per page.

Default 5

detailstring

Full and minimal views only: "light" returns the minimal view. See Response detail.

Default "full"

Pagination cap: page × page_size ≤ 500 (422 above it). When the next page would pass the cap, has_more is false, next_page is null, and _warnings says the limit was reached.

Response:

page, page_size, has_more, next_page

Pagination. next_page is null on the last page.

filings

Event filing objects, each with a sections array of matching event section objects. Empty results return [].

credits_used, _warnings

Credits charged and optional event warnings.

Results are ordered by filing_date descending. Each issuer and accession appears once, including when several share-class symbols match. With items, only matching sections are returned; the filing's items and items_declared remain complete. Original text, prior and amendments are on POST /events/filing.

Credits: 65–280 per page, using the Credit formula (/screener/events) formula.

Errors: 422 VALIDATION_ERROR, 402 CREDITS_INSUFFICIENT, 403 PLAN_TIER_INSUFFICIENT below Pro, 504 EVENTS_QUERY_TIMEOUT at the 30-second query timeout (charged).

#Credit formula (/screener/events)

POST /screener/events charges per page:

Formula
credits = max(65, 200
              − tickerDiscount        // 100 − n distinct requested tickers; 0 when omitted
              − shortWindowDiscount   // 40 when both dates are supplied and differ by ≤ 90 days
              + fullHistorySurcharge) // 80 when start_date is omitted

Range 65–280.

Request scopeCredits per page
One ticker, both dates within 90 days65
All companies, both dates within 90 days160
All companies, a longer range with start_date200
All companies, no start_date280

Charged even when filings is empty, and on 504 EVENTS_QUERY_TIMEOUT. No charge on validation, authentication, endpoint-tier, insufficient-credit or rate-limit errors.