Skip to content

CalMatters/fppc700-download

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

fppc700-download

A CLI tool to download Form 700 PDF reports from the California Fair Political Practices Commission database.

Note: This tool is currently a prototype and may not be further developed.

Usage: fppc700-download [OPTIONS]

Options:
  --filer-first-name TEXT         First name starts with search query
  --filer-last-name TEXT          Last name starts with search query
  --filer-position TEXT           Position of filer, default is "Assembly Member"
  --filing-year INTEGER           Year for data in report
  --output-directory TEXT         Path to destination directory of PDF files, default is .
  --amendments-only               Only search for Amendment filings
  --currently-held-positions-only Limit to reports by filers with a current position
  --ignore-existing-files         Only download files that do not exist in output directory
  --help                          Show this message and exit.

Examples

The following command would download all of the 2025 FPPC Form 700 reports for judges who have a last name that starts with "K" into the current directory:

fppc700-download --filing-position Judge --filer-last-name K --filing-year 2025 --output-directory .

The following command would download all of the 2025 FPPC Form 700 reports for Assembly Members who are currently holding any position into the current directory, skipping any that have already been downloaded:

fppc700-download --filing-position "Assembly Member" --filing-year 2025 --output-directory . --currently-held-positions-only --ignore-existing-files

Installation

You can install the CLI tool from this Github repository using pip or uv:

pip install git+https://github.com/CalMatters/fppc700-download.git
uv pip install "git+https://github.com/CalMatters/fppc700-download.git"

Motivation

We made this tool because we needed it! And we're sharing it publicly in case other folks need it or have ideas for improvement.

We've gone through and extracted data from the Form 700 documents filed by the entire legislator the past few years (for filings regarding 2022, 2023, 2024, 2025) in a relatively time-consuming process. However, starting in 2025 AB1170 required legislators to submit their reports electronicly which means that all the documents have exactly the same layout.

Please let us know if you use this tool!

If you end up using this tool, please get in touch and share your use case with us by sending an email to jeremia@calmatters.org.

About

A command-line tool to download Form 700 documents from the California FPPC

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages