# SEC EDGAR Filings Lookup via agentshelf.syntexa.ch

> SEC EDGAR Filings Lookup via agentshelf.syntexa.ch is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-26).

Fetches the latest SEC EDGAR filings for a given US equity ticker or CIK, with optional form-type filtering and result count control, returning filing metadata and URLs.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/sec-edgar-filings?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-filings-lookup-via-agentshelf-syntexa-ch-b39187d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kPNo4H6FyuJahfTpSZeIX

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 sec-edgar-filings-lookup-via-agentshelf-syntexa-ch-b39187d7 -d '<json body>'
```

Example prompt: Can you get me the most recent 10-K annual report filing for Apple from SEC EDGAR — just the latest one?

## When to prefer this

Use this endpoint when an AI agent needs structured, up-to-date SEC EDGAR filing records for a US public company, especially when the agent knows the ticker or CIK and wants to retrieve specific form types like 10-K or 8-K with direct filing URLs. Prefer this over scraping EDGAR directly because it handles the required SEC User-Agent header, caches the ticker-to-CIK map for speed, and returns clean structured JSON ready for downstream processing. It is well-suited for financial research agents, compliance bots, or any workflow that needs to programmatically access recent regulatory filings.

## Known failure modes

- Ticker not found in SEC company_tickers.json map — returns error for unknown or delisted tickers
- CIK not valid or not found in EDGAR — returns error
- Requesting more than 25 filings (limit exceeds maximum) — returns validation error
- Sending both ticker and CIK — returns error asking for only one identifier
- Form type not exactly matching (e.g. '10-K/A' not matched by '10-K') — returns empty or fewer results
- Payment not included or insufficient USDC — returns 402 Payment Required
- Requesting more than 5 comma-separated form types — returns validation error

## How this service works

Call when an agent needs the latest SEC EDGAR filings for a ticker or CIK, with an optional form filter, a limit, and filing URLs. The ticker map is cached. The call sends SEC's required User-Agent. Recent submissions only. Send JSON {"ticker":"AAPL","form":"10-K","limit":1}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/sec-edgar-filings first.

## Output

Returns a list of the most recent SEC EDGAR filings for the specified company, ordered newest first, including filing metadata such as form type, filing date, accession number, and direct URLs to each filing document on EDGAR.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "description": "SEC CIK, 1 to 10 digits. Example: 320193 for Apple. Padded to 10 digits. Send cik or ticker, not both."
  },
  "form": {
   "type": "string",
   "examples": [
    "10-K"
   ],
   "description": "Comma-separated SEC form types. Example: 10-K or 10-K,8-K. At most 5. Match is exact, so 10-K does not include 10-K/A. Omit it for every form."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "examples": [
    1
   ],
   "description": "How many matching filings to return, newest first. Example: 1. Default 10. At most 25."
  },
  "ticker": {
   "type": "string",
   "pattern": "^[A-Za-z][A-Za-z0-9.-]{0,9}$",
   "examples": [
    "AAPL"
   ],
   "description": "US equity ticker. Example: AAPL. Looked up in the SEC company_tickers.json map. Send ticker or cik, not both."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-filings-lookup-via-agentshelf-syntexa-ch-b39187d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)
