Downloading specific filings

[GilletClement]

Hello

From my understanding, the common practice to download filings is:

filings = get_filings(form="8-K")
download_filings(filings=filings)

However, the available filters are limited. I would like to download only 8-K filings containing specific items.

What I’m trying to do

period = range(2006, 2026)
set_of_items = set(['Item 2.05', 'Item 7.01', 'Item 8.01'])

for year_int in period:
    filings_8k = get_filings(form="8-K", year=year_int)
    for j in range(0, len(filings_8k)):
        eight_k = filings_8k[j].obj()
        items = eight_k.items
        if items and not set_of_items.isdisjoint(items):
            download_filings(filings_8k[j])

Error
download_filings(filings_8k[j])

Traceback (most recent call last):

  File ".../edgar/storage.py", line 317, in download_filings
    start_date_tm, end_date_tm, is_range = extract_dates(filing_date)

  File ".../edgar/dates.py", line 38, in extract_dates
    has_colon = ':' in date_str

TypeError: argument of type 'Filing' is not a container or iterable

So:

• Is it possible to build an iterable filings object similar to the one returned by get_filings?
• Is there a way to download a single filing?

Thanks!

[dgunning]

You want to download 8-Ks between 2006 and 2026 but only if it has those items? That's a lot of data. You are better off trying https://github.com/john-friedman/datamule-python

If you want to use edgartools the fix for your exception is

from edgar import *
from tqdm.auto import tqdm

period = range(2006, 2026)
set_of_items = {'Item 2.05', 'Item 7.01', 'Item 8.01'}

filings_8k = get_filings(form="8-K", year=[2026])
accession_numbers = []

for filing in tqdm(filings_8k):
    eight_k = filing.obj()
    items = set(eight_k.items)
    if not set_of_items.isdisjoint(set(items)):
        accession_numbers.append(filing.accession_number)

filings = filings_8k.filter(accession_number=accession_numbers)
filings.download()

[GilletClement]

Hi, thank you very much for the documentation and suggestions
I have a question regarding how to correctly access item content from an 8-K filing.

In the documentation, I found

from edgar import *

filing = get_filings(form="8-K").latest()
eight_k = filing.obj()
eight_k

# Stock split announcements (Item 8.01 or 5.03)
if 'Item 8.01' in eight_k.items or 'Item 5.03' in eight_k.items:
    content = eight_k.get('8.01') or eight_k.get('5.03') or ''
    if 'split' in content.lower():
        print(f"Stock split announced: {filing.filing_date}")

However, when I try to run similar code, I receive the following error: AttributeError: 'CurrentReport' object has no attribute 'get' when calling eight_k.get('Item 8.01'). I wanted to confirm whether .get() is still supported for CurrentReport objects or if the API has changed and now it should only be eight_k['2.02'] or eight_k['Item 2.02']?

Documentation reference: https://edgartools.readthedocs.io/en/latest/eightk-filings/?h=8+k.

Also, is it possible to download SEC filings with datamule and then use edgartools parsers ?

Thank you very much for your help!

[dgunning]

I am currently working on integrating with datamule. This could be available this weekend if testing goes well