sec: Find entities who made SEC filings

In tarakc02/discoveryengine: A CADS Prospecting Tool

Find entities who made SEC filings

Description

Find entities who have filed an SEC Form 3/4/5. Data is based on a match of CADS entities to SEC disclosures

Usage

sec_filed(
  ...,
  from = NULL,
  to = NULL,
  director = NULL,
  officer = NULL,
  ten_percenter = NULL,
  other = NULL,
  title_text = NULL,
  verified = NULL
)

Arguments

...	Central Index Key for one or more companies – if blank, will look at all SEC filings
from	begin and end dates (filed between those dates). Enter as integer of the form YYYYMMDD
to	begin and end dates (filed between those dates). Enter as integer of the form YYYYMMDD
director	Look for people listed as directors? See details
officer	Look for people listed as officers? See details
ten_percenter	Look for people listed as ten percent owners? See details
other	Look for people with some other relationship to the company? See details
title_text	Search term to look for in filer's free-text entry for officer or other
verified	See details

Details

By default, all matched filings are included in the search. If verified is TRUE, then only those that have been verified by the Prospect Discovery Team are included. If verified is FALSE, then only filings that have NOT been verified by Prospect Discovery are included. #' Since this is based on a probabilistic match score, there will be some false positive matches. If perfect accuracy is necessary, be sure to manually review the results. You might want to use the 'screening' chunk from the ‘discoappend' package, which outputs links to filings on the SEC’s website.

SEC Form 4 includes checkboxes for "Director," "Officer," "ten percent owner," and "Other" to specify the filer's relationship to the company. Furthermore, filers who check "officer" can enter their title as free text, and those who check "Other" can similarly enter their title or other explanatory text. Search these entries using the 'title_text' argument.

Value

A definition of type entity_id

Examples

## look up companies using the usual look-up feature
sec_filed(?twitter)

## with a code, i can now pull any filers with Twitter:
sec_filed(1418091)

## To look for anyone who's filed during calendar year 2017:
sec_filed(1418091, from = 20170101, to = 20171231)

## find people who are 10% owners of any company
sec_filed(ten_percenter = TRUE)

## find filers with any company who have listed their title as "chairman"
sec_filed(title_text = "chairman")

tarakc02/discoveryengine documentation built on Sept. 26, 2023, 12:17 a.m.