Name: SEC EDGAR API: Filings, Full-Text Search, Financials
Brand: martindata
SKU: api-martindata-sec-edgar-api
Availability: InStock
Author: API Market

# SEC EDGAR API

## Overview

The SEC EDGAR API gives you US Securities and Exchange Commission filings as clean JSON through a single endpoint with four modes. Company filings returns a company's filings by ticker or CIK, full-text search finds every filing that mentions a phrase, latest returns the newest filings across all companies, and financials returns annual or quarterly figures such as revenue, net income, cash flow and debt taken from the XBRL data in 10-K and 10-Q reports.

It is built for fintech developers, equity researchers, compliance teams and data engineers who need EDGAR data without writing their own scraper or parsing XBRL. Every filing comes with its form type, filing date, 8-K item codes, tickers and direct links to the document and filing index on sec.gov, and every financials row carries the fiscal period, the source filing and computed margins.

## Features

*   **1 endpoint, 4 modes**: `company_filings`, `search`, `latest` and `financials`, chosen with the `mode` field.
*   **Filter by form**: 10-K, 10-Q, 8-K, S-1, Form 4, 13F-HR, DEF 14A and more, plus 8-K item codes.
*   **Full-text search**: search the text of EDGAR filings for any phrase, such as "going concern" or "cybersecurity incident".
*   **Financials from XBRL**: revenue, gross profit, operating and net income, EPS, cash, debt, assets, equity and margins per fiscal year or quarter.
*   **Tickers or CIKs**: look companies up by stock ticker or SEC CIK number.
*   **Date filters**: `postedWithinDays`, or an exact `dateFrom` and `dateTo` range.
*   **Up to 100 results per call**: set with `maxItems`.
*   **Rate limit**: up to 10 requests per second on every plan.

## Use Cases

*   **Event-driven trading**: watch the latest 8-Ks for earnings releases (item 2.02) or officer changes (item 5.02).
*   **Equity research**: pull several years of revenue, margins and cash flow for a list of tickers.
*   **Risk and compliance**: search every filing for phrases like "going concern" or "material weakness".
*   **Fintech apps**: show a company's recent 10-K, 10-Q and 8-K filings with links to the original documents.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/martindata/sec-edgar-api
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Company filings

Returns the filings of one or more companies, newest first. Use `forms` to limit the result to specific form types.

**Method:** `POST`

**Endpoint:** `/m/sec-edgar-scraper`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `company_filings` | string | Yes | - | - |
| tickers | body | Stock tickers (such as `MSFT`) or SEC CIK numbers | array of strings | Yes | - | - |
| forms | body | Form types to include, such as `10-K` or `8-K`. Empty returns all forms | array of strings | No | - | - |
| postedWithinDays | body | Only filings from the last N days. `0` means no limit | integer | No | 0 | - |
| dateFrom | body | Start date (YYYY-MM-DD). Overrides `postedWithinDays` | string | No | - | - |
| dateTo | body | End date (YYYY-MM-DD) | string | No | Today | - |
| eightKItems | body | Only 8-Ks with these item codes, such as `2.02` (results) or `5.02` (officer change) | array of strings | No | - | - |
| includeCompanyInfo | body | Adds industry (SIC), state, exchange, website, phone and business address to each filing | boolean | No | - | - |
| contactEmail | body | Your contact email, sent to the SEC in the User-Agent header as the SEC asks of automated tools | string | No | - | - |
| maxItems | body | Maximum number of results returned in this call | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/sec-edgar-api/m/sec-edgar-scraper' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "company_filings",
  "tickers": [
    "MSFT"
  ],
  "forms": [
    "10-K",
    "8-K"
  ],
  "postedWithinDays": 120,
  "maxItems": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 3,
  "items": [
    {
      "acceptedAt": "2026-10-28T20:11:03.000Z",
      "accessionNumber": "0001193125-26-436149",
      "cik": "0000789019",
      "companyName": "MICROSOFT CORP",
      "description": "8-K",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/789019/000119312526436149/msft-20261028.htm",
      "fileNumber": "001-37845",
      "filingDate": "2026-10-28",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/789019/000119312526436149/0001193125-26-436149-index.htm",
      "form": "8-K",
      "hasXBRL": true,
      "id": "0001193125-26-436149",
      "itemDescriptions": [
        "Other Events",
        "Financial Statements and Exhibits"
      ],
      "items": [
        "8.01",
        "9.01"
      ],
      "primaryDocument": "msft-20261028.htm",
      "reportDate": "2026-10-28",
      "scrapedAt": "2026-11-04T19:33:57Z",
      "sizeBytes": 32501116,
      "tickers": [
        "MSFT"
      ],
      "type": "filing"
    },
    {
      "acceptedAt": "2026-10-28T20:04:44.000Z",
      "accessionNumber": "0001193125-26-436122",
      "cik": "0000789019",
      "companyName": "MICROSOFT CORP",
      "description": "8-K",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/789019/000119312526436122/msft-20261028.htm",
      "fileNumber": "001-37845",
      "filingDate": "2026-10-28",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/789019/000119312526436122/0001193125-26-436122-index.htm",
      "form": "8-K",
      "hasXBRL": true,
      "id": "0001193125-26-436122",
      "itemDescriptions": [
        "Results of Operations and Financial Condition",
        "Financial Statements and Exhibits"
      ],
      "items": [
        "2.02",
        "9.01"
      ],
      "primaryDocument": "msft-20261028.htm",
      "reportDate": "2026-10-28",
      "scrapedAt": "2026-11-04T19:33:57Z",
      "sizeBytes": 840348,
      "tickers": [
        "MSFT"
      ],
      "type": "filing"
    }
  ]
}
```

#### 2. Full-text search

Searches the full text of EDGAR filings for each phrase in `keywords` and returns the matching filings with the phrase that matched.

**Method:** `POST`

**Endpoint:** `/m/sec-edgar-scraper`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `search` | string | Yes | - | - |
| keywords | body | Phrases to search for. Each phrase is one search | array of strings | Yes | - | - |
| forms | body | Form types to include | array of strings | No | - | - |
| tickers | body | Optional filter to one or more companies | array of strings | No | - | - |
| postedWithinDays | body | Only filings from the last N days | integer | No | 30 | - |
| dateFrom | body | Start date (YYYY-MM-DD). Overrides `postedWithinDays` | string | No | - | - |
| dateTo | body | End date (YYYY-MM-DD) | string | No | Today | - |
| includeCompanyInfo | body | Adds industry (SIC), state, exchange, website, phone and business address to each filing | boolean | No | - | - |
| contactEmail | body | Your contact email, sent to the SEC in the User-Agent header as the SEC asks of automated tools | string | No | - | - |
| maxItems | body | Maximum number of results returned in this call | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/sec-edgar-api/m/sec-edgar-scraper' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "search",
  "keywords": [
    "artificial intelligence"
  ],
  "forms": [
    "8-K"
  ],
  "postedWithinDays": 30,
  "maxItems": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 3,
  "items": [
    {
      "accessionNumber": "0001062993-26-005174",
      "businessLocation": "Ferndale, MI",
      "cik": "0001498148",
      "companyName": "Artificial Intelligence Technology Solutions Inc.",
      "description": "EXHIBIT 99.1",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005174/exhibit99-1.htm",
      "fileNumber": "000-55079",
      "filingDate": "2026-10-05",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005174/0001062993-26-005174-index.htm",
      "form": "8-K",
      "id": "0001062993-26-005174|\"artificial intelligence\"",
      "itemDescriptions": [
        "Other Events",
        "Financial Statements and Exhibits"
      ],
      "items": [
        "8.01",
        "9.01"
      ],
      "matchedDocument": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005174/exhibit99-1.htm",
      "otherFilers": [],
      "primaryDocument": "exhibit99-1.htm",
      "reportDate": "2026-10-05",
      "scrapedAt": "2026-11-04T18:55:31Z",
      "searchPhrase": "artificial intelligence",
      "sic": "7372",
      "stateOfIncorporation": "NV",
      "tickers": [
        "AITX"
      ],
      "type": "filing"
    },
    {
      "accessionNumber": "0001062993-26-005318",
      "businessLocation": "Ferndale, MI",
      "cik": "0001498148",
      "companyName": "Artificial Intelligence Technology Solutions Inc.",
      "description": "EXHIBIT 99.1",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005318/exhibit99-1.htm",
      "fileNumber": "000-55079",
      "filingDate": "2026-10-14",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005318/0001062993-26-005318-index.htm",
      "form": "8-K",
      "id": "0001062993-26-005318|\"artificial intelligence\"",
      "itemDescriptions": [
        "Other Events",
        "Financial Statements and Exhibits"
      ],
      "items": [
        "8.01",
        "9.01"
      ],
      "matchedDocument": "https://www.sec.gov/Archives/edgar/data/1498148/000106299326005318/exhibit99-1.htm",
      "otherFilers": [],
      "primaryDocument": "exhibit99-1.htm",
      "reportDate": "2026-10-14",
      "scrapedAt": "2026-11-04T18:55:31Z",
      "searchPhrase": "artificial intelligence",
      "sic": "7372",
      "stateOfIncorporation": "NV",
      "tickers": [
        "AITX"
      ],
      "type": "filing"
    }
  ]
}
```

#### 3. Latest filings

Returns the newest filings from all companies, newest first. Without `forms` it returns 8-Ks.

**Method:** `POST`

**Endpoint:** `/m/sec-edgar-scraper`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `latest` | string | Yes | - | - |
| forms | body | Form types to include. Defaults to `8-K` | array of strings | No | - | - |
| tickers | body | Optional filter to one or more companies | array of strings | No | - | - |
| eightKItems | body | Only 8-Ks with these item codes, such as `2.02` (results) or `5.02` (officer change) | array of strings | No | - | - |
| postedWithinDays | body | Only filings from the last N days | integer | No | 30 | - |
| includeCompanyInfo | body | Adds industry (SIC), state, exchange, website, phone and business address to each filing | boolean | No | - | - |
| contactEmail | body | Your contact email, sent to the SEC in the User-Agent header as the SEC asks of automated tools | string | No | - | - |
| maxItems | body | Maximum number of results returned in this call | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/sec-edgar-api/m/sec-edgar-scraper' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "latest",
  "forms": [
    "8-K"
  ],
  "maxItems": 3
}'
```

**Example Response (200 OK):**

```json
{
  "count": 3,
  "items": [
    {
      "accessionNumber": "0002078008-26-000023",
      "businessLocation": "Schaffhausen",
      "cik": "0002078008",
      "companyName": "Versigent PLC",
      "description": "8-K",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/2078008/000207800826000023/vgnt-20261104.htm",
      "fileNumber": "001-42957",
      "filingDate": "2026-11-04",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/2078008/000207800826000023/0002078008-26-000023-index.htm",
      "form": "8-K",
      "id": "0002078008-26-000023",
      "itemDescriptions": [
        "Results of Operations and Financial Condition",
        "Financial Statements and Exhibits"
      ],
      "items": [
        "2.02",
        "9.01"
      ],
      "otherFilers": [],
      "primaryDocument": "vgnt-20261104.htm",
      "reportDate": "2026-11-04",
      "scrapedAt": "2026-11-04T18:55:31Z",
      "sic": "3714",
      "stateOfIncorporation": "Y9",
      "tickers": [
        "VGNT"
      ],
      "type": "filing"
    },
    {
      "accessionNumber": "0002077096-26-000300",
      "businessLocation": "Manchester, X0",
      "cik": "0001096056",
      "companyName": "LUXFER HOLDINGS PLC",
      "description": "CURRENT REPORT",
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/1096056/000207709626000300/ea0310850-8k_luxfer.htm",
      "fileNumber": "001-35370",
      "filingDate": "2026-11-04",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1096056/000207709626000300/0002077096-26-000300-index.htm",
      "form": "8-K",
      "id": "0002077096-26-000300",
      "itemDescriptions": [
        "Submission of Matters to a Vote of Security Holders",
        "Other Events"
      ],
      "items": [
        "5.07",
        "8.01"
      ],
      "otherFilers": [],
      "primaryDocument": "ea0310850-8k_luxfer.htm",
      "reportDate": "2026-11-04",
      "scrapedAt": "2026-11-04T18:55:31Z",
      "sic": "2810",
      "stateOfIncorporation": "X0",
      "tickers": [
        "LXFR"
      ],
      "type": "filing"
    }
  ]
}
```

#### 4. Financials

Returns annual or quarterly financial figures for each company, taken from the XBRL data in its 10-K and 10-Q filings.

**Method:** `POST`

**Endpoint:** `/m/sec-edgar-scraper`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Set to `financials` | string | Yes | - | - |
| tickers | body | Stock tickers or SEC CIK numbers | array of strings | Yes | - | - |
| periodType | body | `annual` or `quarterly` | string | No | - | - |
| years | body | Number of fiscal years to return per company | integer | No | - | - |
| contactEmail | body | Your contact email, sent to the SEC in the User-Agent header as the SEC asks of automated tools | string | No | - | - |
| maxItems | body | Maximum number of results returned in this call | integer | No | 20 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/martindata/sec-edgar-api/m/sec-edgar-scraper' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "financials",
  "tickers": [
    "NVDA"
  ],
  "periodType": "annual",
  "years": 2,
  "maxItems": 2
}'
```

**Example Response (200 OK):**

```json
{
  "count": 2,
  "items": [
    {
      "accessionNumber": "0001045810-26-000021",
      "capitalExpenditure": null,
      "cashAndEquivalents": 10605000000,
      "cik": "0001045810",
      "companyName": "NVIDIA CORP",
      "costOfRevenue": 62475000000,
      "currency": "USD",
      "epsBasic": 4.93,
      "epsDiluted": 4.9,
      "filedAt": "2026-02-25",
      "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000021/0001045810-26-000021-index.htm",
      "fiscalPeriod": "FY",
      "fiscalYear": 2026,
      "form": "10-K",
      "freeCashFlow": null,
      "grossMarginPct": 71.07,
      "grossProfit": 153463000000,
      "id": "0001045810-annual-2026-01-25",
      "longTermDebt": 7469000000,
      "netIncome": 120067000000,
      "netMarginPct": 55.6,
      "operatingCashFlow": 102718000000,
      "operatingIncome": 130387000000,
      "periodEnd": "2026-01-25",
      "periodStart": "2025-01-27",
      "periodType": "annual",
      "researchAndDevelopment": 18497000000,
      "revenue": 215938000000,
      "scrapedAt": "2026-11-04T18:55:31Z",
      "stockholdersEquity": 157293000000,
      "ticker": "NVDA",
      "totalAssets": 206803000000,
      "totalLiabilities": 49510000000,
      "type": "financials"
    }
  ]
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than 10 requests per second. Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

Every plan allows up to 10 requests per second. Subscription plans also have a monthly call quota shown on the pricing page. Sending more than 10 requests per second returns `429 Too Many Requests`. Throttle your client to stay under 10 requests per second, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Which mode should I use?**

    Use `company_filings` for one company's filings, `search` to find filings that mention a phrase, `latest` for the newest filings across all companies, and `financials` for revenue, income and balance sheet figures.

*   **Can I use a CIK instead of a ticker?**

    Yes. `tickers` accepts stock tickers such as `AAPL` or SEC CIK numbers such as `320193`.

*   **Why are some financial fields null?**

    The figures come from the XBRL data the company filed. When a company does not report a value under a standard tag, such as capital expenditure, the field is `null`.

*   **How many results can I get per call?**

    Up to 100, set with `maxItems`. The default is 20.

*   **What is contactEmail for?**

    The SEC asks automated tools to identify themselves. If you set `contactEmail`, it is sent to the SEC in the User-Agent header and nowhere else.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Get SEC EDGAR filings by ticker, full-text search, the latest 8-Ks and XBRL financials as clean JSON for research and fintech apps.

SEC EDGAR API: Filings, Full-Text Search, Financials