# ScrapeMole Companies – SEC EDGAR Filings List

> ScrapeMole Companies – SEC EDGAR Filings List is a paid API for AI agents from companies.scrapemole.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Retrieves a paginated list of SEC EDGAR filings (with document links) for a given company by ticker or CIK, optionally filtered by form type and date.

## Facts

- Endpoint: GET https://companies.scrapemole.workers.dev/v1/filings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-companies-sec-edgar-filings-list-5cebe965
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4gg6vcxuwylV-3TesHQTk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapemole-companies-sec-edgar-filings-list-5cebe965
```

Example prompt: Pull the last 10 SEC filings for Apple (ticker AAPL) — just 10-K and 8-K forms, nothing older than 2023-01-01.

## When to prefer this

Use this endpoint when you need to enumerate a company's SEC filing history with direct document links — especially when you know the ticker or CIK and want to filter by specific form types (10-K, 8-K, S-1, etc.) or a date window. Prefer this over general web search when you need structured, authoritative filing metadata straight from EDGAR without scraping.

## Known failure modes

- Missing both ticker and cik returns an error — exactly one must be provided
- Unknown ticker or CIK returns empty filings array or 404
- Invalid form type string may return empty results
- Invalid date format for 'since' parameter causes a bad request error
- Limit out of range (not 1–100) may cause a validation error
- Payment not included or insufficient USDC causes 402 response with no charge

## How this service works

Pay-per-call US company data for agents from SEC EDGAR (public domain): company/ticker search, company profiles (industry, incorporation, filer category, addresses, latest filings), XBRL financials (revenue, net income, EPS, cash flow, balance sheet; 5 years + 4 quarters) and filing lists with document links. USDC via x402, no accounts; failed calls are never charged.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://companies.scrapemole.workers.dev/terms

## Output

Returns a JSON object with the company's CIK, name, filing count, and an array of filings each containing form type, items, filing date, report date, accession number, SEC index URL, and direct document URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC CIK. Give ticker or cik."
      },
      "forms": {
       "type": "string",
       "description": "Comma-separated form types (amendments included), e.g. \"10-K,8-K\". Default: 10-K,10-Q,8-K,20-F,6-K,40-F,S-1,DEF 14A,424B4. Use \"all\" for every company form."
      },
      "limit": {
       "type": "string",
       "default": "20",
       "description": "Max filings (1-100)."
      },
      "since": {
       "type": "string",
       "description": "Only filings on or after this date (YYYY-MM-DD)."
      },
      "ticker": {
       "type": "string",
       "examples": [
        "AAPL"
       ],
       "description": "Stock ticker. Give ticker or cik."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": 320193,
  "name": "Apple Inc.",
  "count": 1,
  "filings": [
   {
    "form": "8-K",
    "items": "2.02,9.01",
    "indexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.htm",
    "filingDate": "2026-07-31",
    "reportDate": "2026-07-31",
    "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260731.htm",
    "accessionNumber": "0000320193-26-000018"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-companies-sec-edgar-filings-list-5cebe965/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.scrapemole.workers.dev](https://www.zero.xyz/host/companies.scrapemole.workers.dev/llms.txt)