# Mekler AI SEC Filings Finder

> Mekler AI SEC Filings Finder is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Find SEC filings for a company by CIK, filtered by form type and date range, returning accession IDs, amendment flags, and canonical SEC links in newest-first order.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/finance/filings/find-company-filings?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-sec-filings-finder-e278e694
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wIjKZVlEQNZgdgIPilk0M

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 mekler-ai-sec-filings-finder-e278e694 -d '<json body>'
```

Example prompt: Pull the five most recent 10-K and 10-K/A filings for Apple — their CIK is 0000320193 — filed between 2020-01-01 and 2025-12-31, and give me the accession numbers and SEC links.

## When to prefer this

Use this endpoint when you need structured metadata about SEC filings for a specific company identified by CIK, especially when filtering by form type and date range is required. Prefer this over direct EDGAR queries when you need clean accession identifiers, amendment flags, and canonical SEC links in a structured JSON format with explicit coverage reporting. Not suitable for resolving tickers to CIKs, fetching filing contents, or obtaining financial statement data (use the sibling GAAP facts endpoint for that).

## Known failure modes

- Invalid CIK format returns a validation error
- No filings found for the given filters returns an empty filings array
- Date range too narrow yields zero results
- form type string not matching EDGAR conventions returns no matches
- Upstream SEC EDGAR unavailability may cause timeouts or error status
- More than 5 archive partitions exist but only 5 are read — unread history is surfaced in coverage metadata but not fetched

## How this service works

Find SEC filings by company CIK, form and filing date. Return accession identifiers, amendment flags and canonical SEC links, newest first. Includes recent submissions and up to five relevant archived partitions with explicit unread-history coverage. Metadata only; no filing contents, ticker resolution or investment advice.

## Output

Returns a JSON object containing the company CIK, source URL, a list of filings (each with form type, filed date, accession number, filing index URL, report date, primary document URL, and amendment flag), coverage metadata (history partitions read, whether all history was covered), total returned count, a selection policy identifier, retrieval timestamp, and a limitations array explaining scope constraints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "pattern": "^[0-9]{1,10}$"
  },
  "forms": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Z0-9][A-Z0-9 /-]{0,19}$"
   },
   "default": [],
   "maxItems": 5
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1
  },
  "to_date": {
   "type": "string",
   "format": "date"
  },
  "from_date": {
   "type": "string",
   "format": "date"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{16,64}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "source": "https://data.sec.gov/submissions/CIK0000320193.json",
  "status": "ok",
  "filings": [
   {
    "form": "10-K",
    "filed": "2026-01-31",
    "accession": "0000000001-26-000001",
    "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000000000126000001/0000000001-26-000001-index.html",
    "report_date": "2025-12-31",
    "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000000000126000001/annual.htm",
    "is_amendment": false
   }
  ],
  "coverage": {
   "history_files_read": 0,
   "result_limit_reached": false,
   "unread_history_files": 0,
   "complete_source_history": true,
   "matched_in_read_sources": 1
  },
  "returned": 1,
  "limitations": [
   "Amendments are distinct filings; no inference of the latest legal state.",
   "At most five relevant archive partitions are read; unread history is explicit.",
   "Metadata only; no filing contents or investment advice."
  ],
  "retrieved_at": "2026-10-18T00:00:00Z",
  "selection_policy": "filing-date-descending-accession-descending-v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mekler-ai-sec-filings-finder-e278e694/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mekler.ai](https://www.zero.xyz/host/api.mekler.ai/llms.txt)