# EDGAR Full-Text Search

> **You are on:** `https://beta-api.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | beta-api.paywithlocus.com |
> | Stage | stage.paywithlocus.com | stage-api.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Full-text search across all SEC filings — 10-Ks, 10-Qs, 8-Ks, proxy statements, and more. Search by keyword, company name, form type, and date range.

**Category:** Data / Finance | **Website:** [efts.sec.gov](https://efts.sec.gov) | **Docs:** [efts.sec.gov/LATEST/search-index](https://efts.sec.gov/LATEST/search-index)

## Access Methods

| Method | Base URL | Auth |
|--------|----------|------|
| **MPP (Tempo)** | `https://edgar-search.mpp.paywithlocus.com/edgar-search/` | HTTP 402 auto-payment |
| **Wrapped API** | `https://beta-api.paywithlocus.com/api/wrapped/edgar-search/` | `Authorization: Bearer <LOCUS_API_KEY>` |

**OpenAPI discovery:** `GET https://edgar-search.mpp.paywithlocus.com/openapi.json`

## Endpoints

### Search Filings

Search the full text of all SEC filings by keyword, company, form type, and date range. Returns matching filings with filing dates, entity names, form types, and accession numbers.

**Estimated cost:** $0.005 + $0.003 fee

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q` | string | Yes | Search query (e.g. "climate risk", "going concern", "material weakness") |
| `forms` | string | No | Comma-separated form types to filter by (e.g. "10-K", "10-Q,8-K") |
| `dateRange` | string | No | Set to "custom" to use startdt/enddt |
| `startdt` | string | No | Start date in YYYY-MM-DD format |
| `enddt` | string | No | End date in YYYY-MM-DD format |
| `entity` | string | No | Filter by company name |
| `hits` | number | No | Number of results to return (default 10, max 10) |

```bash
curl -X POST https://edgar-search.mpp.paywithlocus.com/edgar-search/search \
  -H "Content-Type: application/json" \
  -d '{"q":"<string>","forms":"<string>","dateRange":"<string>","startdt":"<string>","enddt":"<string>","entity":"<string>","hits":"<number>"}'
```