# 10-K, 10-Q and XBRL company facts API

Give it a list of tickers or CIK numbers (the SEC's company ID number) and get one clean row per company: its profile, its filing history with direct links, and its latest key financial facts.

**From USD 0.50 per 1,000 companies.** On the Apify Store since 13 November 2026. Checked 14 November 2026. Apify Store page: https://apify.com/tan-solutions/company-filings

## What it does

US Company Filings and Financials reads SEC EDGAR public data through the official public JSON endpoints. For each company you list it returns the company profile, the filings you ask for (10-K, 10-Q, 8-K, S-1 and more, newest first, each with a direct link) and the latest annual value of key financial facts.

The facts are revenue, net income, earnings per share, assets, liabilities, equity, cash, operating cash flow and shares outstanding, plus any extra XBRL concepts you name. You pay per company returned; companies it could not find or fetch cost nothing.

- **Finds each company.** Looks up each ticker in the official ticker list, or takes the CIK number you give.
- **Filters filings.** Keeps only the form types and filing dates you ask for, newest first, up to the number per company you set.
- **Picks key facts.** The latest annual value of 11 key metrics plus shares outstanding, and any extra XBRL concepts you name.
- **Identifies you properly.** Every request carries your company name and contact email, as the SEC asks, at a polite pace.
- **Stops cleanly.** If the SEC asks it to slow down, it waits once, tries once more and otherwise stops. Companies it could not fetch are listed and free.

## Who it is for

- Analysts and investors who want filings and key numbers for a watchlist in one table.
- Developers and AI agents that need clean, structured company data from one API call.
- Sales and research teams who check public companies by ticker.

## What it costs

**From USD 0.50 per 1,000 companies.** You pay per result. The price depends on your Apify plan:

| Apify plan tier | Price per 1,000 companies |
|---|---|
| FREE | USD 0.80 |
| BRONZE | USD 0.65 |
| SILVER | USD 0.55 |
| GOLD | USD 0.50 |

Free, never charged: tickers that are not found; invalid entries; companies that could not be fetched; the one row that tells you to add your name and email. Apify also charges a small start event per run.

## Input

The fields you will most likely change:

| Field | What it does | Default |
|---|---|---|
| `companies` | Tickers or CIK numbers, one per line. At most 1,000 per run. Required. | AAPL, MSFT, 320193 |
| `companyName, contactEmail` | Your company or name, and an address where the SEC can reach you. Sent only to the SEC. Required by the SEC. | none |
| `forms` | Form types to keep, such as 10-K, 10-Q or 8-K. Empty means all company forms. | all |
| `includeAmendments` | Also keep amendments (10-K/A for 10-K). | on |
| `filedAfter, filedBefore` | Filing date window, as YYYY-MM-DD. | none |
| `maxFilingsPerCompany` | Filings per company, newest first, 0 to 2,000. 0 returns the profile and facts only. | 20 |
| `includeFacts` | Add the key financial facts. | on |
| `extraConcepts` | More XBRL concepts, such as us-gaap:ResearchAndDevelopmentExpense (at most 30). | none |
| `maxCompanies` | Cap on companies per run, at most 1,000. | 100 |
| `requestsPerSecond` | Pace, 0.5 to 5. Lower it if you run several jobs at the same time. | 2 |

A small input to start from:

```json
{
  "companies": [
    "AAPL",
    "MSFT"
  ],
  "forms": [
    "10-K",
    "10-Q"
  ],
  "companyName": "Your Company",
  "contactEmail": "you@your-company.com"
}
```

## Output

One row per company. This is a real row from a run on 13 November 2026, shortened to one filing and two of the twelve facts:

```json
{
  "input": "AAPL",
  "status": "ok",
  "cik": "0000320193",
  "name": "Apple Inc.",
  "tickers": [
    "AAPL"
  ],
  "exchanges": [
    "Nasdaq"
  ],
  "sicDescription": "Electronic Computers",
  "fiscalYearEnd": "0926",
  "filingsMatched": 315,
  "filingsReturned": 20,
  "filings": [
    {
      "form": "10-K",
      "filingDate": "2026-11-03",
      "reportDate": "2026-09-26",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/aapl-20260926.htm"
    }
  ],
  "keyFacts": [
    {
      "metric": "revenue",
      "unit": "USD",
      "value": 478834000000,
      "fiscalYear": 2026,
      "form": "10-K",
      "periodEnd": "2026-09-26"
    },
    {
      "metric": "netIncome",
      "unit": "USD",
      "value": 132175000000,
      "fiscalYear": 2026,
      "form": "10-K",
      "periodEnd": "2026-09-26"
    }
  ],
  "scrapedAt": "2026-11-13T09:40:19.578Z"
}
```

The status is "ok", "not_found", "invalid_input", "individual_filer", "not_fetched", "error" or "too_large". Every row that is not "ok" has an error code and a plain message, and a summary record lists the counts and why the run stopped. Download as JSON, CSV or Excel, or read them through the API.

## How to run it

### In Apify Console, no code

1. Add your tickers or CIK numbers in "Companies".
2. Add your company or your name, and your contact email. The SEC requires every automated tool to say who is behind it. These two go only into the request header sent to the SEC; they are never in your results, and the email is masked in the log.
3. Click Start. A few companies take a few seconds; 100 companies take about 4 minutes.

Start from the tool's page (https://apify.com/tan-solutions/company-filings). You need an Apify account.

### From the API

One call runs the tool and returns the results. Replace `<YOUR_API_TOKEN>` with your token from Apify Console (Settings, API and Integrations). Add "companyName" and "contactEmail" (the SEC requires them); without them the run returns one free row.

```bash
curl -X POST "https://api.apify.com/v2/acts/tan-solutions~company-filings/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"companies":["AAPL","MSFT"],"forms":["10-K","10-Q"],"companyName":"Your Company","contactEmail":"you@your-company.com"}'
```

### From an AI agent, through MCP

Apify's MCP server offers this tool alone to your MCP client at `https://mcp.apify.com?tools=tan-solutions/company-filings`. The client signs in to Apify on first connect, or sends your token in an `Authorization: Bearer` header.

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=tan-solutions/company-filings"
    }
  }
}
```

## Run it on a schedule

Check your watchlist every weekday evening and see each company's newest filings and facts the next morning. In Apify Console: Schedules, Create new, cron `0 22 * * 1-5` (every weekday at 22:00 UTC), then add this tool with your input. Or as one API call (`GLcxOiTSuBPtnhkhU` is this tool's Actor ID):

```bash
curl -X POST "https://api.apify.com/v2/schedules?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "company-filings-schedule",
  "cronExpression": "0 22 * * 1-5",
  "timezone": "UTC",
  "isEnabled": true,
  "isExclusive": true,
  "actions": [
    {
      "type": "RUN_ACTOR",
      "actorId": "GLcxOiTSuBPtnhkhU",
      "runInput": {
        "body": "{\"companies\":[\"AAPL\",\"MSFT\"],\"forms\":[\"10-K\",\"10-Q\"],\"companyName\":\"Your Company\",\"contactEmail\":\"you@your-company.com\"}",
        "contentType": "application/json"
      }
    }
  ]
}'
```

## Limits

- At most 1,000 companies per run (100 by default). There is no "all companies" mode; for every filer, use the SEC's own nightly bulk files.
- It sends one request at a time, 2 per second by default and never more than 5, well under the SEC's limit. It never uses proxies or changes identity.
- Facts are what each company tagged in XBRL. Companies tag differently and filings can be amended, so some metrics are missing for some companies.
- Filing documents are linked, not downloaded. There is no full filing text in this version.
- Individual filers (insiders and beneficial owners) are skipped unless you turn on insider filings, and their personal contact details are never returned.

## Questions

### Why do I have to give my name and email?

The SEC requires every automated tool to say who is behind it in the request header. Your details go only to the SEC in that header. Placeholder addresses such as example.com are refused.

### What if a ticker is not found?

You get a free "not_found" row for it. Tickers change after mergers and renames; the CIK number always works.

### What happens if the SEC slows me down?

The run pauses once for up to 10 minutes and tries again. If the SEC still says no, the run ends cleanly, the rest are listed as "not_fetched" and you pay nothing for them.

### Can I get only annual reports?

Yes. Set forms to 10-K, or set maxFilingsPerCompany to 0 for the profile and facts only.

Not affiliated with, endorsed or approved by the U.S. Securities and Exchange Commission. SEC and EDGAR are marks of the U.S. Securities and Exchange Commission. Built and run by Tan Solutions.

Source: https://www.tansolutions.org/tools/company-filings/ · Tan Solutions
