Event objects

Corporate event summaries, original filing text, attachments and amendment history for US companies. The /events/* endpoints require Starter or higher. Cross-company and date-filtered searches use POST /screener/events.

#Event filing object

Returned by POST /events/filings, POST /events/filing and POST /screener/events.

id

Filing identifier, used as filing_id on POST /events/filing.

ticker, issuer_cik

Company symbol, and the 10-digit CIK this filing was filed under.

accession_number

SEC accession number.

form_type

Filing type as reported.

filing_date

Filing date, YYYY-MM-DD.

period_of_report

Reported event date, YYYY-MM-DD.

items

Item codes represented by the filing's current sections.

items_declared

Item codes declared in the filing.

merge_status

Amendment association: null (none), confirmed, likely, or unresolved (standalone amendment).

source_url_prefix

Base URL for resolving each section's source_locator, including relative ../ paths.

#Event section object

Returned in sections by POST /events/filing and POST /screener/events.

item, title

Item code and section title.

summary

Current event summary, including available amendments.

source_accession, source_locator

Source accession and document path for the summary. Resolve the path against the filing's source_url_prefix.

source_filing_date

Filing date of source_accession, YYYY-MM-DD.

restated

null, added, modified or cancelled.

prior

Previous summaries, when available: {accession, filing_date, summary} entries, newest first. Returned only by POST /events/filing.

The detail response also includes amendments when available. Each entry contains accession, source_locator, amendment_type, amendment_filing_date, sections_added, sections_restated, merge_key (amendment reference label), and amendment_reason (text or null).

Attachments are returned as exhibits when requested. Each entry contains exhibit, description, source_locator, source_accession and text (null when the attachment has no text).

#Event warnings

_warnings is omitted when there are no notices. Identical messages appear once.

Different items and items_declared sets produce a filing-level notice. List and screening responses combine the affected filing count for that page into one notice.
Selecting items on the detail endpoint produces a notice if sections are omitted.
Reading a standalone unresolved amendment produces a notice.
Returned attachments without text produce a notice.
History limits, the company's other symbols or CIKs (Company symbols and CIKs) and the screening pagination cap may produce notices.