# SEC EDGAR Filings (submissions + full-text search) (`darikami/sec-edgar-filings`) Actor

SEC EDGAR filing metadata and links for US companies: form, filed and report dates, accession number, 8-K items, XBRL flags, document URLs. By ticker or CIK, form type and date, or by EDGAR full-text search. Company filers only, no filing text, no API key.

- **URL**: https://apify.com/darikami/sec-edgar-filings.md
- **Developed by:** [DARIKAMI GmbH](https://apify.com/darikami) (community)
- **Categories:** Developer tools, Automation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 filing delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEC EDGAR Filings (submissions + full-text search)

**The filings of US-listed companies, from the SEC's EDGAR system (submissions API and full-text search).**
Form, filing and report dates, accession number, 8-K items, XBRL flags and the links to the filing - no filing text.
**USD 0.001 per filing (USD 1 per 1,000).** Unknown tickers and searches without a match are free. No API key.

| Ticker | Form | Filed | Period | 8-K items | Accession number |
|---|---|---|---|---|---|
| AAPL | 10-K | 2026-11-03 | 2026-09-26 | | 0000320193-26-000026 |
| AAPL | 8-K | 2026-11-02 | 2026-11-02 | 2.02, 9.01 | 0000320193-26-000024 |
| AAPL | 8-K/A | 2026-09-01 | 2026-04-17 | 5.02 | 0001140361-26-035325 |
| MSFT | 8-K | 2026-10-28 | 2026-10-28 | 2.02, 9.01 | 0001193125-26-436122 |
| MSFT | 10-K | 2026-07-29 | 2026-06-30 | | 0001193125-26-323660 |

The rows come from a cloud run of 04.11.2026 (the example input). Each item also has the links to the filing index and
its main document, the XBRL flags, the file and film numbers and the company's industry.

### Who uses it

- **Portfolio and event monitoring:** the new 8-Ks of a watch list (earnings 2.02, officer changes 5.02) each morning.
- **Research and AI agents:** the 10-K and 10-Q links of a sector, ready to download or to feed to a model.
- **Due diligence and compliance:** the filings since 2001 that mention a phrase, a product or a counterparty.

### What it does not do

- It does not copy the text of a filing. Follow `filingIndexUrl` or `primaryDocumentUrl` for that.
- It does not return filings of persons: no insider forms 3, 4, 5 or 144 ("Personal data" below).
- It does not parse financial figures. For those, use
  [SEC company fundamentals](https://apify.com/darikami/sec-company-fundamentals).

### Input

A company list (complete, since 1994):

```json
{ "companies": ["AAPL", "MSFT", "320193"], "forms": ["10-K", "8-K"], "dateFrom": "2025-01-01", "maxFilingsPerCompany": 10 }
```

A full-text search (filings since 2001):

```json
{ "query": "\"share repurchase\"", "companies": ["AAPL", "MSFT"], "forms": ["10-K"], "dateFrom": "2023-01-01" }
```

| Field | Meaning |
|---|---|
| `companies` | Tickers (`AAPL`, `BRK.B` or `BRK-B`) or SEC CIK numbers (`320193` or `0000320193`). Up to 1,000 per run. Empty: search all of EDGAR (then give a query or form types). |
| `forms` | EDGAR form types: `10-K`, `10-Q`, `8-K`, `S-1`, `DEF 14A`, `20-F`, `SC 13G` and others. Empty: all forms. Forms 3, 4, 5, 144 and MA-I are not served. |
| `query` | Optional. EDGAR full-text search: words (all required), `"exact phrases"`, `OR`, `-word`, `NEAR(5)`, `stem*`. |
| `dateFrom`, `dateTo` | Filing dates, `YYYY-MM-DD`, both included. Empty: no limit. |
| `includeAmendments` | Default `true`: `10-K/A` comes with `10-K`. An amendment named in `forms` always comes. |
| `maxFilings` | The run stops after this many filings. Default 100. |
| `maxFilingsPerCompany` | Optional cap per company. |

How the actor reads EDGAR:

- **Companies without a query:** each company's own filing list from the SEC submissions API. A company's list is newest
  first.
- **A query, or no companies:** the EDGAR full-text search. Its results come in order of relevance.
- **A Schedule 13D or 13G for your companies:** a full-text search for each company, after its list. Only the search
  names every party of the filing (see "Personal data"). The other forms of the run still come from the list.

`SC 13G` and `SCHEDULE 13G` are the old and new names of the same form (EDGAR renamed them in December 2024). Each one
asks for both.

### Output (one item per filing)

```json
{
  "input": "AAPL",
  "cik": "0000320193",
  "companyName": "Apple Inc.",
  "tickers": ["AAPL"],
  "exchanges": ["Nasdaq"],
  "entityType": "operating",
  "sic": "3571",
  "industry": "Electronic Computers",
  "accessionNumber": "0000320193-26-000026",
  "form": "10-K",
  "filingDate": "2026-11-03",
  "reportDate": "2026-09-26",
  "acceptanceDateTime": "2026-11-03T13:05:15.000Z",
  "act": "34",
  "fileNumber": "001-36743",
  "filmNumber": "261514222",
  "items": [],
  "sizeBytes": 10902198,
  "isXBRL": true,
  "isInlineXBRL": true,
  "primaryDocument": "aapl-20260926.htm",
  "primaryDocDescription": "10-K",
  "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/aapl-20260926.htm",
  "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-26-000026-index.htm",
  "parties": null,
  "matchedDocuments": null,
  "error": null,
  "message": null,
  "source": "SEC EDGAR submissions API (data.sec.gov) - filing metadata as published by the SEC",
  "sourceUrl": "https://data.sec.gov/submissions/CIK0000320193.json",
  "retrievedAt": "2026-11-04T22:00:35.245Z"
}
```

- `items` are the 8-K item numbers, for example `["2.02", "9.01"]` (results of operations, exhibits).
- `reportDate` is the period of the report. EDGAR leaves it empty for some forms: then it is `null`.
- Two fields are filled only for a filing from the full-text search (else `null`):
  - `parties` lists every company named on the filing, for example the issuer and the holder of a Schedule 13G.
  - `matchedDocuments` lists the documents of the filing that matched, each with its URL.
- A search item has no `acceptanceDateTime`, `sizeBytes`, XBRL flags or primary document: the search does not give them.
  `filingIndexUrl` leads to all documents of the filing.
- A free item (`error` set) has the same fields, most of them `null`. `message` says why.

### Pricing (pay per event)

| Event | Price | When |
|---|---|---|
| `filing` | **USD 0.001** | one filing delivered |

100 filings cost USD 0.10. 10,000 filings cost USD 10. These items are free:

- an unknown ticker;
- an input that is not a ticker or a CIK;
- a CIK that is not a company filer;
- a company or a search without a matching filing.

A filing that two of your companies share is charged once.

### Data source and terms

- **Source:** the SEC's EDGAR system:
  - the submissions API on `data.sec.gov` (`/submissions/CIK##########.json`), which holds each filer's filing list;
  - EDGAR full-text search (`efts.sec.gov/LATEST/search-index`), which covers "the full text of all EDGAR filings
    submitted electronically since 2001";
  - tickers from `https://www.sec.gov/files/company_tickers.json`.
- The SEC states that its EDGAR APIs "do not require any authentication or API keys to access".
- **Terms:** the SEC states: "Information presented on sec.gov is considered public information and may be copied or
  further distributed by users of the web site without the SEC's permission." Each item names its source.
- **Fair access:** the SEC writes: "Current guidelines limit each user to a total of no more than 10 requests per
  second, regardless of the number of machines used to submit requests." It asks automated tools to declare a
  User-Agent.
- This actor is not affiliated with or endorsed by the U.S. Securities and Exchange Commission.

### Personal data

EDGAR also holds filings of persons: insiders, holders of shares, people who sell restricted stock. This actor returns
filings of companies only:

1. A filer counts as a company only when EDGAR types it as `operating` or `investment`. EDGAR types persons as `other`.
   Some firms are `other` too, and their filings are left out as well.
2. Forms 3, 4, 5 and 144 are reports of insiders on their own shares. Form MA-I describes one person of a municipal
   advisor. These forms are not returned.
3. A full-text search filing is returned only when every party on it is a company. A Schedule 13G that an investment
   firm files on a company passes. A Schedule 13G of a person does not.
4. A company list leaves out the forms that a third party files about the company: Schedule 13D/G, a shareholder's
   nominee notice, exempt, contested and dissident proxy material, a bidder's tender offer. The list does not name that
   party. Ask for such a form by name: then the actor searches for it and checks each party.
5. The actor returns metadata and links. It does not copy the text of a filing, and it does not return a company's
   addresses or phone number.

A CIK that is not a company gives a free item without a name.

A company named after a person keeps its name, because it is a legal person.

### What the data is - and is not

- The metadata is **as published by the SEC**. The filing itself (`filingIndexUrl`) is the authoritative text.
- **This is not investment advice.** The actor delivers data. It does not rate or recommend any security.

### Limits

- The full-text search covers filings since 2001. For older filings, give companies without a query.
- The full-text search returns at most 10,000 documents per query. The run log says when a query reaches this limit:
  then narrow the dates or forms.
- The full-text search ranks by relevance. `maxFilings` therefore keeps the most relevant filings, not the newest.
- A search stops after 1,000 matching filings with a party that is not a company. The run log says so: then narrow it.

### Run summary

The run summary is in the default key-value store under `SUMMARY`, the counts under `STATS`.
The data comes as the source publishes it, without warranty.

**More official-data actors by darikami:** [SEC company fundamentals](https://apify.com/darikami/sec-company-fundamentals) · [Swiss UID & VAT validator](https://apify.com/darikami/swiss-uid-validator) · [Swiss electricity tariffs](https://apify.com/darikami/swiss-electricity-tariffs) · [German public tenders](https://apify.com/darikami/german-public-tenders) · [VIN decoder](https://apify.com/darikami/vin-decoder).
In an AI agent: ask the Apify MCP server (`mcp.apify.com`) for `darikami/sec-edgar-filings`.

# Actor input Schema

## `companies` (type: `array`):

Tickers (AAPL, BRK.B or BRK-B) or SEC CIK numbers (320193 or 0000320193), one per line. Up to 1,000 per run. Empty: search all of EDGAR (then give a query or form types).

## `forms` (type: `array`):

EDGAR form types such as 10-K, 10-Q, 8-K, S-1, DEF 14A, 20-F, SC 13G. Empty: all forms. Amendments (10-K/A) come with their form unless switched off below. Forms 3, 4, 5 and 144 (insider reports of persons) are not served.

## `query` (type: `string`):

Searches the full text of filings since 2001 with EDGAR full-text search: words (all required), "exact phrases", OR, -exclusions, NEAR(5), stem\* wildcards. Empty: the companies' filing lists (complete, since 1994).

## `dateFrom` (type: `string`):

First filing date (YYYY-MM-DD). Empty: no lower limit.

## `dateTo` (type: `string`):

Last filing date, included (YYYY-MM-DD). Empty: up to today.

## `includeAmendments` (type: `boolean`):

Return amendments (10-K/A, 8-K/A ...) together with their form. An amendment named in Form types is always returned.

## `maxFilings` (type: `integer`):

The run stops after this many filings (the newest first in a company's list; the most relevant first in a search). Each filing is one charged event.

## `maxFilingsPerCompany` (type: `integer`):

Optional cap per company, so one company cannot use up the whole run. Empty: no cap per company.

## Actor input object example

```json
{
  "companies": [
    "AAPL",
    "MSFT"
  ],
  "forms": [
    "10-K",
    "8-K"
  ],
  "includeAmendments": true,
  "maxFilings": 100
}
```

# Actor output Schema

## `results` (type: `string`):

One item per filing: company, form, filed and report dates, accession number, 8-K items and the links to the filing.

## `summary` (type: `string`):

SUMMARY record: pushed, charged, attempts, errors, stoppedByBudget, ok, message.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "AAPL",
        "MSFT"
    ],
    "forms": [
        "10-K",
        "8-K"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("darikami/sec-edgar-filings").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "companies": [
        "AAPL",
        "MSFT",
    ],
    "forms": [
        "10-K",
        "8-K",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("darikami/sec-edgar-filings").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    "AAPL",
    "MSFT"
  ],
  "forms": [
    "10-K",
    "8-K"
  ]
}' |
apify call darikami/sec-edgar-filings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,darikami/sec-edgar-filings"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/z1yHVNb89MypBnz6r/builds/tQ0CbImlfwLjgdP8D/openapi.json