# EDGAR (SEC)

> **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.

> SEC EDGAR public financial data — company filing history, XBRL financial facts (income statements, balance sheets, cash flows), and full-text search across all public filings. No API key required.

**Category:** Data / Finance | **Website:** [www.sec.gov/developer](https://www.sec.gov/developer) | **Docs:** [www.sec.gov/developer](https://www.sec.gov/developer)

## Access Methods

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

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

## Endpoints

### Company Submissions

Full filing history and company metadata for any SEC filer. Returns company name, SIC code, tickers, exchanges, addresses, fiscal year end, and the most recent 1,000 filings with form types, dates, and accession numbers.

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

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number (e.g. "320193" for Apple). Automatically zero-padded to 10 digits. |

```bash
curl -X POST https://edgar.mpp.paywithlocus.com/edgar/company-submissions \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>"}'
```

### Company Facts

All XBRL financial data for a company across all filed reports — revenue, net income, assets, liabilities, equity, EPS, and 100s of other metrics from 10-K/10-Q/8-K filings. Returns structured time series per concept.

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

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number (e.g. "320193" for Apple) |

```bash
curl -X POST https://edgar.mpp.paywithlocus.com/edgar/company-facts \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>"}'
```

### Company Concept

Time series for a single XBRL financial concept — retrieve every reported value for a specific metric (e.g. Assets, Revenues, NetIncomeLoss) across all filings. Smaller and faster than company-facts for targeted queries.

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

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number (e.g. "320193" for Apple) |
| `taxonomy` | string | Yes | XBRL taxonomy: us-gaap, ifrs-full, dei, or srt |
| `tag` | string | Yes | XBRL concept tag (e.g. "Assets", "Revenues", "NetIncomeLoss", "EarningsPerShareBasic") |

```bash
curl -X POST https://edgar.mpp.paywithlocus.com/edgar/company-concept \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>","taxonomy":"<string>","tag":"<string>"}'
```