# SEC Full-Text Search

> SEC Full-Text Search is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-28).

Full-text search across all SEC filings since 2001 by keyword or exact phrase, filterable by form type and date range.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/us-stocks/full-text-search?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-full-text-search-26f557d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pwYemPq5zF-YERJmrmr3d

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-full-text-search-26f557d6
```

Example prompt: Search all SEC 10-K and 10-Q filings from 2020-01-01 to 2023-12-31 for the exact phrase "supply chain disruption" and return up to 50 results — I want to see which companies disclosed that risk and when.

## When to prefer this

Use this endpoint when you need to search the actual text content of SEC regulatory filings — not just metadata or financial figures — to find specific mentions of risks, events, companies, products, or phrases. It is ideal for investment research, compliance monitoring, competitive intelligence, and due diligence tasks that require scanning thousands of public disclosures. Prefer this over general web search when you need verifiable, dated regulatory source documents.

## Known failure modes

- Missing required 'q' parameter returns an error
- Date range in wrong format (not YYYY-MM-DD) causes a 400 error
- Very broad queries with no filters may return truncated or low-quality results
- Queries for filings before 2001 will return no results as the index starts then
- Invalid form type strings in 'forms' parameter may return empty results
- Rate limiting or server unavailability on the hosted render instance

## How this service works

Search the full text of all SEC filings since 2001 for any word or exact phrase (in quotes), filtered by form type (10-K, 8-K, S-1...) and date: company, form, filing date, period and document link. Use to find every filing mentioning a risk, product, customer or event.

## Output

A list of matching SEC filings, each including the company name, form type (e.g. 10-K, 8-K), filing date, period of report, and a direct link to the filing document on SEC EDGAR.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Words or a quoted exact phrase"
      },
      "end": {
       "type": "string",
       "description": "To date YYYY-MM-DD"
      },
      "forms": {
       "type": "string",
       "description": "Comma-separated form types, e.g. 10-K,8-K"
      },
      "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-100)"
      },
      "start": {
       "type": "string",
       "description": "From date YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-full-text-search-26f557d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)
