# OneShot Agent API – SEC Company Filings Lookup

> OneShot Agent API – SEC Company Filings Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Retrieves SEC EDGAR filings for a company by CIK, with filtering by form type and date range, returning filing metadata and company profile information.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-filings?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-sec-company-filings-lookup-3a2182c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g6cdJclmh9bTwTItHVQru

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 oneshot-agent-api-sec-company-filings-lookup-3a2182c4 -d '<json body>'
```

Example prompt: Can you pull the last 5 SEC filings for Apple — CIK 320193 — and show me only 10-K forms filed after 2020-01-01?

## When to prefer this

Choose this endpoint when you need structured SEC EDGAR filing metadata for a known public company identified by CIK, especially when filtering by form type (10-K, 8-K, 10-Q, etc.) or date range. It is ideal for investment research, compliance checks, and due diligence workflows where you need direct links to official SEC filings. Prefer this over general web search when you need authoritative, structured regulatory filing data rather than news summaries.

## Known failure modes

- Invalid or unknown CIK returns found:false with no filings
- CIK not zero-padded correctly may cause lookup failure
- No filings match the specified form type or date range — returns empty filings array
- Limit out of range (below 1 or above 50) may return an error
- Payment failure via x402 if insufficient USDC balance on Base

## How this service works

Look up a US public company's registry record and recent filings by its registry identifier.

## Output

Returns a JSON object with the company's EDGAR profile (name, CIK, address, phone, tickers, exchanges, industry, entity type, fiscal year end, former names, state of incorporation) and a list of matching filings each containing the form type, filing date, period end date, accession number, description, and a direct URL to the filing document on SEC.gov.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "description": "The registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros. A CIK is 1 to 10 digits."
  },
  "form": {
   "type": "string",
   "description": "Only filings of this exact form type, for example 10-K. 1 to 20 characters."
  },
  "limit": {
   "type": "integer",
   "description": "Most filings to return, newest first. From 1 to 50. Defaults to `10`."
  },
  "filed_after": {
   "type": "string",
   "description": "Only filings made on or after this date. Use YYYY-MM-DD."
  },
  "filed_before": {
   "type": "string",
   "description": "Only filings made on or before this date. Use YYYY-MM-DD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "city": "CUPERTINO",
  "name": "Apple Inc.",
  "found": true,
  "phone": "(408) 996-1010",
  "state": "CA",
  "street": "ONE APPLE PARK WAY",
  "filings": [
   {
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm",
    "form": "8-K",
    "filed_on": "2026-07-30",
    "period_end": "2026-07-30",
    "description": "8-K",
    "accession_number": "0000320193-26-000018"
   }
  ],
  "tickers": [
   "AAPL"
  ],
  "website": null,
  "industry": "Electronic Computers",
  "exchanges": [
   "Nasdaq"
  ],
  "entity_type": "operating",
  "postal_code": "95014",
  "former_names": [
   "APPLE INC",
   "APPLE COMPUTER INC",
   "APPLE COMPUTER INC/ FA"
  ],
  "industry_code": "3571",
  "fiscal_year_end": "0926",
  "state_of_incorporation": "CA"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-sec-company-filings-lookup-3a2182c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)