Start with the filing type
The form number determines whether you are reading an initial holding, a change in ownership, an annual catch-up, or a proposed sale notice.
A SEC ownership filing discovered from EDGAR and tracked through ingestion, XML resolution, download, parsing, and processing. Each filing has a durable identity (its accession number) and a lifecycle of states — discovered, XML resolved, XML downloaded, processed, or failed.
The form number determines whether you are reading an initial holding, a change in ownership, an annual catch-up, or a proposed sale notice.
CIKs, accession numbers, and SEC URLs are durable references. They are safer than company names when matching across systems.
A Form 144 proposed sale is not the same thing as an executed Form 4 sale. Keep proposed-sale context separate from transaction rows.
filing