# SEC EDGAR API
> US public-company filings and financial statements straight from the U.S. SEC EDGAR system. Search 10,000+ companies (ticker → CIK), list a company's recent filings (10-K, 10-Q, 8-K and more) with document links, pull XBRL financial-statement time series (revenue, assets, net income and any GAAP concept) and run full-text search across all EDGAR filings. Ideal for fintech, fundamental analysis, compliance and research.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/edgar-api/..."
```

## Pricing
- **Free** (Free) — 1,000 calls/Mo, 1 req/s
- **Starter** ($29/Mo) — 50,000 calls/Mo, 5 req/s
- **Pro** ($99/Mo) — 500,000 calls/Mo, 20 req/s
- **Enterprise** ($399/Mo) — 2,000,000 calls/Mo, 50 req/s

## Endpoints

### Companies

#### `GET /v1/companies` — Search companies (ticker → CIK)

**Parameters:**
- `q` (query, required, string) — Ticker or company name Example: `apple`
- `limit` (query, optional, string) — Max results (1-100, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/edgar-api/v1/companies?q=apple&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 6,
        "query": "apple",
        "results": [
            {
                "cik": 1134982,
                "name": "Apple iSports Group, Inc.",
                "ticker": "AAPI"
            },
            {
                "cik": 320193,
                "name": "Apple Inc.",
                "ticker": "AAPL"
            },
            {
                "cik": 1418121,
                "name": "Apple Hospitality REIT, Inc.",
                "ticker": "APLE"
            },
            {
                "cik": 63330,
                "name": "MAUI LAND & PINEAPPLE CO INC",
                "ticker": "MLP"
            },
            {
                "cik": 1938109,
                "name": "Pineapple Financial Inc.",
                "ticker": "PAPL"
            },
            {
                "cik": 1710495,
                "name": "PINEAPPLE EXPRESS CANNABIS Co",
                "ticker": "PNXP"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T23:31:45.544Z",
        "request_id": "7a2c0541-cb76-409f-93e1-2c2543c4f039"
    },
    "status": "ok",
    "message": "Companies retrieved",
    "success": true
}
```

### Filings

#### `GET /v1/filings` — Recent SEC filings for a company

**Parameters:**
- `ticker` (query, required, string) — Ticker symbol (or use cik) Example: `AAPL`
- `cik` (query, optional, string) — CIK number (alternative to ticker)
- `form` (query, optional, string) — Filter by form type, e.g. 10-K, 10-Q, 8-K Example: `10-K`
- `limit` (query, optional, string) — Max filings (1-100, default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/edgar-api/v1/filings?ticker=AAPL&form=10-K&limit=20"
```

**Response:**
```json
{
    "data": {
        "cik": 320193,
        "sic": "Electronic Computers",
        "name": "Apple Inc.",
        "count": 11,
        "ticker": "AAPL",
        "filings": [
            {
                "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
                "form": "10-K",
                "accession": "0000320193-25-000079",
                "description": "10-K",
                "filing_date": "2025-10-31",
                "report_date": "2025-09-27",
                "primary_document": "aapl-20250927.htm"
            },
            {
                "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
                "form": "10-K",
                "accession": "0000320193-24-000123",
                "description": "10-K",
                "filing_date": "2024-11-01",
                "report_date": "2024-09-28",
                "primary_document": "aapl-20240928.htm"
            },
            {
                "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
                "form": "10-K",
                "accession": "0000320193-23-000106",
                "description": "10-K",
                "filing_date": "2023-11-03",
                "report_date": "2023-09-30",
                "primary_document": "aapl-20230930.htm"
            },
            {
                "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019322
…(truncated, see openapi.json for full schema)
```

### Financials

#### `GET /v1/financials` — XBRL financial-statement concept time series

**Parameters:**
- `ticker` (query, required, string) — Ticker symbol (or use cik) Example: `AAPL`
- `cik` (query, optional, string) — CIK number (alternative to ticker)
- `tag` (query, optional, string) — XBRL concept, e.g. Assets, Revenues, NetIncomeLoss Example: `Assets`
- `taxonomy` (query, optional, string) — Taxonomy (default us-gaap) Example: `us-gaap`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/edgar-api/v1/financials?ticker=AAPL&tag=Assets&taxonomy=us-gaap"
```

**Response:**
```json
{
    "data": {
        "cik": 320193,
        "tag": "Assets",
        "name": "Apple Inc.",
        "unit": "USD",
        "count": 40,
        "label": "Assets",
        "series": [
            {
                "end": "2020-12-26",
                "form": "10-Q",
                "unit": "USD",
                "filed": "2021-01-28",
                "start": null,
                "value": 354054000000,
                "fiscal_year": 2021,
                "fiscal_period": "Q1"
            },
            {
                "end": "2021-03-27",
                "form": "10-Q",
                "unit": "USD",
                "filed": "2021-04-29",
                "start": null,
                "value": 337158000000,
                "fiscal_year": 2021,
                "fiscal_period": "Q2"
            },
            {
                "end": "2021-06-26",
                "form": "10-Q",
                "unit": "USD",
                "filed": "2021-07-28",
                "start": null,
                "value": 329840000000,
                "fiscal_year": 2021,
                "fiscal_period": "Q3"
            },
            {
                "end": "2021-09-25",
                "form": "10-K",
                "unit": "USD",
                "filed": "2021-10-29",
                "start": null,
                "value": 351002000000,
                "fiscal_year": 2021,
                "fiscal_period": "FY"
            },
            {
                "end": "2021-09-25",
            
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search-filings` — Full-text search across all EDGAR filings

**Parameters:**
- `q` (query, required, string) — Search text Example: `apple`
- `form` (query, optional, string) — Filter by form type Example: `10-K`
- `limit` (query, optional, string) — Max results (1-50, default 10) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/edgar-api/v1/search-filings?q=apple&form=10-K&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "apple",
        "total": 10000,
        "results": [
            {
                "cik": null,
                "form": "10-K",
                "company": "Apple Hospitality REIT, Inc.  (APLE)  (CIK 0001418121)",
                "accession": "0001185185-15-000457",
                "filing_date": "2015-03-06"
            },
            {
                "cik": null,
                "form": "10-K",
                "company": "APPLE COMPUTER INC  (AAPL)  (CIK 0000320193)",
                "accession": "0001047469-03-041604",
                "filing_date": "2003-12-19"
            },
            {
                "cik": null,
                "form": "10-K",
                "company": "Snap Interactive, Inc  (PALT)  (CIK 0001355839)",
                "accession": "0001213900-11-001691",
                "filing_date": "2011-03-31"
            },
            {
                "cik": null,
                "form": "10-K",
                "company": "Apple Hospitality REIT, Inc.  (APLE)  (CIK 0001418121)",
                "accession": "0000950170-23-003449",
                "filing_date": "2023-02-21"
            },
            {
                "cik": null,
                "form": "10-K",
                "company": "Apple Hospitality REIT, Inc.  (APLE)  (CIK 0001418121)",
                "accession": "0001185185-17-000461",
                "filing_date": "2017-02-27"
            },
            {
                "cik": null,
      
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Data source & endpoint reference

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/edgar-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "U.S. SEC EDGAR (data.sec.gov / efts.sec.gov)",
        "endpoints": {
            "/v1/filings": "Recent filings (form, date, accession, document URL) for a company by ticker or cik; optional form filter.",
            "/v1/companies": "Search the bundled ticker→CIK directory by ticker or company name.",
            "/v1/financials": "XBRL financial-statement concept time series (taxonomy + tag, e.g. us-gaap / Revenues) by ticker or cik.",
            "/v1/search-filings": "Full-text search across all EDGAR filings; optional form filter."
        },
        "companies_indexed": 10365
    },
    "meta": {
        "timestamp": "2026-05-30T23:31:47.280Z",
        "request_id": "c3466530-db98-472f-89ef-6de8e31764e0"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/edgar-api
OpenAPI spec: https://www.oanor.com/api/edgar-api/openapi.json
