# SEC EDGAR Filings API (edgar.apitoll.cloud)

> SEC EDGAR Filings API (edgar.apitoll.cloud) is a paid API for AI agents from edgar.apitoll.cloud, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Retrieves normalized SEC EDGAR filings (10-K, 10-Q, 8-K) for a company by ticker or CIK, returning a structured envelope with resolved company info, filing items, and metadata.

## Facts

- Endpoint: GET https://edgar.apitoll.cloud/v1/edgar/filings
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-apitoll-cloud-3eec86d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lkWLJCXumWr5JzbzRQaks

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 edgar-apitoll-cloud-3eec86d6
```

Example prompt: Pull the last 5 10-K annual filings for AAPL from SEC EDGAR, including any amendments, going back to 2020-01-01.

## When to prefer this

Use this endpoint when you need normalized, structured SEC EDGAR filing data for a public company and want to resolve by ticker symbol without manually looking up CIK numbers. It is ideal for financial research agents, compliance tools, and equity analysis workflows that need 10-K, 10-Q, or 8-K data with a clean envelope format. Prefer it over raw data.sec.gov calls when you need ticker-to-CIK resolution, amendment surfacing, and a consistent JSON schema out of the box.

## Known failure modes

- Ticker not found or not matched to a CIK — returns an error or empty resolved object
- CIK and ticker both provided simultaneously — schema requires XOR, returns validation error
- Form type not in supported set (10-K, 10-Q, 8-K) and not a recognized alias — returns 400
- Phase 2 forms (Form 4, 13F-HR) requested — routes to 503 stub endpoint
- since date older than 5 years — rejected by schema pattern or returns empty results
- limit out of range (0 or >50) — schema validation error
- Payment not provided or invalid — x402 payment required response

## How this service works

Latest SEC EDGAR filings for any US-listed company by stock ticker or CIK: 10-K annual reports, 10-Q quarterly reports, and 8-K material events. Resolves ticker to CIK via SEC's official index and returns the parsed filing (company, form type, dated items). Sourced live from data.sec.gov.

## Output

A JSON envelope containing: the resolved company object (name, CIK, ticker), an items[] array of normalized filings each with filingDate, form type, and document references, a truncation object indicating if results were capped, appliedSince date, and a source object pointing to data.sec.gov submissions. Form type and limit are echoed back in a meta block.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "form": "10-K",
   "limit": 5,
   "since": "2024-01-01",
   "ticker": "AAPL",
   "includeAmendments": true
  }
 }
}
```

## 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": [
      "form"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "pattern": "^\\d{1,10}$",
       "description": "SEC CIK (1-10 digits). XOR with ticker."
      },
      "form": {
       "enum": [
        "10-K",
        "10-Q",
        "8-K"
       ],
       "type": "string",
       "description": "SEC form for /filings: 10-K, 10-Q, 8-K. Aliases accepted (10k, 10-q, 8k, annual, quarterly, current-report, material-event). Form 4 and 13F-HR have their own routes — GET /v1/edgar/insider and GET /v1/edgar/holdings."
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Per-form ceiling: 10-K/10-Q/8-K=50."
      },
      "since": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Inclusive lower bound on filingDate (YYYY-MM-DD), within the last 5 years."
      },
      "ticker": {
       "type": "string",
       "pattern": "^[A-Za-z.\\-]{1,10}$",
       "description": "Stock ticker, case-insensitive. XOR with cik."
      },
      "includeAmendments": {
       "type": "boolean",
       "description": "When true (default), amendment suffixes (10-K/A) surface alongside the base form."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "form": {
       "enum": [
        "10-K",
        "10-Q",
        "8-K"
       ],
       "type": "string"
      },
      "meta": {
       "type": "object"
      },
      "count": {
       "type": "integer"
      },
      "items": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "source": {
       "type": "object"
      },
      "resolved": {
       "type": "object"
      },
      "truncation": {
       "type": [
        "object",
        "null"
       ]
      },
      "appliedSince": {
       "type": [
        "string",
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "form": "10-K",
  "meta": {
   "relatedEndpoints": []
  },
  "count": 1,
  "items": [
   {
    "cik": "0000320193",
    "form": "10-K",
    "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
    "immutable": true,
    "filingDate": "2024-11-01",
    "reportDate": "2024-09-28",
    "accessionNumber": "0000320193-24-000123",
    "primaryDocument": "aapl-20240928.htm"
   }
  ],
  "source": {
   "name": "data.sec.gov",
   "fetchedAt": "2026-05-30T14:22:01Z",
   "servedFromCache": true,
   "sourceLastFetchedAt": "2026-05-30T14:11:43Z"
  },
  "resolved": {
   "cik": "0000320193",
   "sic": "3571",
   "cikInt": 320193,
   "ticker": "AAPL",
   "entityType": "operating",
   "companyName": "Apple Inc.",
   "mappingAgeSeconds": 1842,
   "tickerSnapshotDate": "2026-05-30"
  },
  "truncation": null,
  "appliedSince": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-apitoll-cloud-3eec86d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from edgar.apitoll.cloud](https://www.zero.xyz/host/edgar.apitoll.cloud/llms.txt)
