Story

An issuer-level narrative assembled across a company's filings, with the cumulative story and the per-filing events behind it.

Use cases#

Read an issuer's cumulative narrative independent of a single filing.
Trace the per-filing events that shaped the current story.

Response schema#

Fields 9

Field path	Type	Description
`story_so_far`# required	string\| null	The issuer's cumulative narrative — the body a reader renders. Comes from the card of the most recently filed filing (not the latest reporting period — an 8-K's period is its event date); any other filing updates only its own event row and leaves this untouched.
`updated_by`# required	string	`filing_id` of the filing whose card wrote `story_so_far`.
`events`# required	array items: object	Oldest reporting period first — the evidence behind the narrative.
`events[].filing_id`# required	string	The filing's own identifier (SEC accession number).
`events[].form`# required	string	Form
`events[].filing_date`# required	string	Filing Date
`events[].period`# required	string	Reporting period the filing covers. Orders the event list — the filing date does not, because a late submission carries an earlier period.
`events[].core`# required	string\| null	This filing's own core takeaway, copied verbatim from its card.
`events[].link`# required	string\| null	This filing's tie to the prior window, copied verbatim from its card.

Example dataset#

An illustrative example for story. Use it to see the shape of the data before running a live request.

Top-level fields in the example dataset
Field	Summary
story_so_far	The company expanded its core business while investing in new growth initiatives.
updated_by	0000320193-25-000012
events	1 item

Playground#