Filings

Browse historical SEC filings and monitor the real-time 48-hour filing feed.

Prerequisites

  • An edgar.tools API key
  • A company CIK number (use the search endpoint to find one)

1. Get a company's filings

Fetch paginated filings for any company using their CIK number. Control results with page and limit.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/0000320193/filings?page=1&limit=10"
import requests

response = requests.get(
    "https://api.edgar.tools/v1/companies/0000320193/filings",
    params={"page": 1, "limit": 10},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
filings = response.json()

2. Filter by form type

Narrow results to a specific filing type — 10-K (annual reports), 10-Q (quarterly), 8-K (material events), etc.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/companies/0000320193/filings?form_type=10-K"
response = requests.get(
    "https://api.edgar.tools/v1/companies/0000320193/filings",
    params={"form_type": "10-K"},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
annual_reports = response.json()

3. Get filing details

Retrieve full details for a specific filing using the company CIK and accession number. The response includes documents and metadata.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/filings/0000320193/0000320193-24-000081"
response = requests.get(
    "https://api.edgar.tools/v1/filings/0000320193/0000320193-24-000081",
    headers={"Authorization": "Bearer etk_your_key_here"},
)
filing = response.json()

4. Monitor live filings

Access the real-time filing feed to monitor new SEC submissions. Professional tier required. Returns filings from the last 48 hours and supports polling via the since parameter.

curl -H "Authorization: Bearer etk_your_key_here" \
  "https://api.edgar.tools/v1/live/filings?since=2024-01-15T10:00:00"
response = requests.get(
    "https://api.edgar.tools/v1/live/filings",
    params={"since": "2024-01-15T10:00:00"},
    headers={"Authorization": "Bearer etk_your_key_here"},
)
live_filings = response.json()

To summarize

  • Filings endpoint supports pagination with page and limit
  • Filter by form_type to narrow results (10-K, 10-Q, 8-K, etc.)
  • Each filing has a unique accession number for direct access
  • Live feed requires Professional tier and supports polling via since