# SEC EDGAR API

> SEC EDGAR workflow and API: company filings, company financials and insider trades. Returns cik, filings, form type and description as JSON.

SEC EDGAR data from sec.gov: company filings, company financials and insider trades.

- Page: https://fous.com/workflows/sec-edgar
- Handle: `@sec-edgar`
- Category: [Finance](https://fous.com/workflows/category/finance)
- Source website: https://sec.gov/edgar
- Last verified: Sep 29, 2026
- Fous is not affiliated with SEC EDGAR.

## Methods

### Get company filings

Operation `get_company_filings`, version 1. 1 credit per call.

List a public company’s SEC filings, newest first. Search by company name or ticker and optionally narrow by filing type or filing date; older filings are included when available.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"TSLA"` | Company name or stock ticker, for example Tesla or TSLA. |
| `end_date` | string | no | `"2025-12-31"` | Latest filing date, inclusive, for example 2025-12-31. |
| `start_date` | string | no | `"2025-01-01"` | Earliest filing date, inclusive, for example 2025-01-01. |
| `filing_type` | string | no | `"quarterly_report"` | Kind of filing, for example annual_report. Defaults to any. |
| `max_results` | integer | no | `5` | Maximum number of filings to return, for example 20 (up to 100). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company name or stock ticker, for example Tesla or TSLA.",
      "examples": [
        "TSLA",
        "Tesla",
        "Apple"
      ]
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Latest filing date, inclusive, for example 2025-12-31.",
      "examples": [
        "2025-12-31",
        "2021-12-31",
        "2016-12-31"
      ]
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest filing date, inclusive, for example 2025-01-01.",
      "examples": [
        "2025-01-01",
        "2020-01-01",
        "2014-01-01"
      ]
    },
    "filing_type": {
      "enum": [
        "any",
        "annual_report",
        "quarterly_report",
        "current_report",
        "proxy_statement",
        "registration",
        "insider_trades",
        "ownership_over_5_percent"
      ],
      "type": "string",
      "default": "any",
      "description": "Kind of filing, for example annual_report. Defaults to any.",
      "examples": [
        "quarterly_report",
        "ownership_over_5_percent",
        "annual_report"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of filings to return, for example 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        5,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "TSLA",
      "end_date": "2025-12-31",
      "start_date": "2025-01-01",
      "filing_type": "quarterly_report",
      "max_results": 5
    },
    {
      "company": "Tesla"
    },
    {
      "company": "Apple",
      "end_date": "2021-12-31",
      "start_date": "2020-01-01",
      "filing_type": "ownership_over_5_percent",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cik` | string | `"0001318605"` |  |
| `filings` | array |  |  |
| `filings[].form_type` | string | `"10-Q"` | SEC form type. |
| `filings[].description` | string or null | `"10-Q"` |  |
| `filings[].filing_date` | string | `"2025-10-23"` |  |
| `filings[].plain_meaning` | string | `"Quarterly report"` | Plain-language meaning of the form. |
| `filings[].accession_number` | string | `"0001628280-25-045968"` |  |
| `filings[].filing_index_link` | string | `"https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/0001628280-25-045968-index.html"` |  |
| `filings[].main_document_link` | string or null | `"https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/tsla-20250930.htm"` |  |
| `filings[].report_period_date` | string or null | `"2025-09-30"` |  |
| `company_name` | string | `"Tesla, Inc."` |  |

**Example input**

```json
{
  "company": "TSLA",
  "end_date": "2025-12-31",
  "start_date": "2025-01-01",
  "filing_type": "quarterly_report",
  "max_results": 5
}
```

**Example output**

```json
{
  "cik": "0001318605",
  "filings": [
    {
      "form_type": "10-Q",
      "description": "10-Q",
      "filing_date": "2025-10-23",
      "plain_meaning": "Quarterly report",
      "accession_number": "0001628280-25-045968",
      "filing_index_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/0001628280-25-045968-index.html",
      "main_document_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025045968/tsla-20250930.htm",
      "report_period_date": "2025-09-30"
    },
    {
      "form_type": "10-Q",
      "description": "10-Q",
      "filing_date": "2025-07-24",
      "plain_meaning": "Quarterly report",
      "accession_number": "0001628280-25-035806",
      "filing_index_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025035806/0001628280-25-035806-index.html",
      "main_document_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025035806/tsla-20250630.htm",
      "report_period_date": "2025-06-30"
    },
    {
      "form_type": "10-Q",
      "description": "10-Q",
      "filing_date": "2025-04-23",
      "plain_meaning": "Quarterly report",
      "accession_number": "0001628280-25-018911",
      "filing_index_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025018911/0001628280-25-018911-index.html",
      "main_document_link": "https://www.sec.gov/Archives/edgar/data/1318605/000162828025018911/tsla-20250331.htm",
      "report_period_date": "2025-03-31"
    }
  ],
  "company_name": "Tesla, Inc."
}
```

### Get company financials

Operation `get_company_financials`, version 1. 1 credit per call.

Get reported annual or quarterly financial figures for a public company by name or ticker. Quarter-only flows may be calculated from filed year-to-date totals; unavailable figures are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `years` | integer | no | `2` | Number of fiscal years, for example 5. |
| `period` | string | no | `"quarterly"` | Reporting frequency, for example annual. |
| `company` | string | yes | `"MSFT"` | Company name or stock ticker, for example Microsoft or MSFT. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "years": {
      "type": "integer",
      "default": 5,
      "maximum": 15,
      "minimum": 1,
      "description": "Number of fiscal years, for example 5.",
      "examples": [
        2
      ]
    },
    "period": {
      "enum": [
        "annual",
        "quarterly"
      ],
      "type": "string",
      "default": "annual",
      "description": "Reporting frequency, for example annual.",
      "examples": [
        "quarterly",
        "annual"
      ]
    },
    "company": {
      "type": "string",
      "description": "Company name or stock ticker, for example Microsoft or MSFT.",
      "examples": [
        "MSFT",
        "Microsoft",
        "Apple"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "years": 2,
      "period": "quarterly",
      "company": "MSFT"
    },
    {
      "company": "Microsoft"
    },
    {
      "years": 2,
      "period": "annual",
      "company": "Apple"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cik` | string | `"0000789019"` |  |
| `periods` | array |  |  |
| `periods[].cash` | number or null | `20935000000` |  |
| `periods[].quarter` | integer or null | `4` |  |
| `periods[].revenue` | number or null | `90007000000` |  |
| `periods[].net_income` | number or null | `35766000000` |  |
| `periods[].fiscal_year` | integer | `2026` |  |
| `periods[].total_assets` | number or null | `758376000000` |  |
| `periods[].period_end_date` | string | `"2026-06-30"` |  |
| `periods[].accession_number` | string | `"0001193125-26-323660"` |  |
| `periods[].total_liabilities` | number or null | `315989000000` |  |
| `periods[].shares_outstanding` | number or null | `7427000000` |  |
| `periods[].source_filing_date` | string or null | `"2026-07-29"` |  |
| `periods[].source_filing_form` | string | `"10-K"` |  |
| `periods[].source_filing_link` | string | `"https://www.sec.gov/Archives/edgar/data/789019/000119312526323660/"` |  |
| `periods[].operating_cash_flow` | number or null | `55441000000` |  |
| `periods[].stockholders_equity` | number or null | `442387000000` |  |
| `periods[].diluted_earnings_per_share` | number or null | `4.81` |  |
| `currency` | string | `"USD"` |  |
| `company_name` | string | `"MICROSOFT CORPORATION"` |  |

**Example input**

```json
{
  "years": 2,
  "period": "quarterly",
  "company": "MSFT"
}
```

**Example output**

```json
{
  "cik": "0000789019",
  "periods": [
    {
      "cash": 20935000000,
      "quarter": 4,
      "revenue": 90007000000,
      "net_income": 35766000000,
      "fiscal_year": 2026,
      "total_assets": 758376000000,
      "period_end_date": "2026-06-30",
      "accession_number": "0001193125-26-323660",
      "total_liabilities": 315989000000,
      "shares_outstanding": 7427000000,
      "source_filing_date": "2026-07-29",
      "source_filing_form": "10-K",
      "source_filing_link": "https://www.sec.gov/Archives/edgar/data/789019/000119312526323660/",
      "operating_cash_flow": 55441000000,
      "stockholders_equity": 442387000000,
      "diluted_earnings_per_share": 4.81
    },
    {
      "cash": 32105000000,
      "quarter": 3,
      "revenue": 82886000000,
      "net_income": 31778000000,
      "fiscal_year": 2026,
      "total_assets": 694228000000,
      "period_end_date": "2026-03-31",
      "accession_number": "0001193125-26-191507",
      "total_liabilities": 279861000000,
      "shares_outstanding": 7429000000,
      "source_filing_date": "2026-04-29",
      "source_filing_form": "10-Q",
      "source_filing_link": "https://www.sec.gov/Archives/edgar/data/789019/000119312526191507/",
      "operating_cash_flow": 46679000000,
      "stockholders_equity": 414367000000,
      "diluted_earnings_per_share": 4.27
    }
  ],
  "currency": "USD",
  "company_name": "MICROSOFT CORPORATION"
}
```

### Get fund holdings

Operation `get_fund_holdings`, version 1. 1 credit per call.

Get a manager’s 13F portfolio for a quarter, with position sizes and share changes from the previous quarter. Reports only securities disclosed in SEC 13F filings.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `quarter` | string | no | `"2022 Q3"` | Reporting quarter, for example 2026 Q2. Defaults to the latest available. |
| `investor` | string | yes | `"Berkshire Hathaway"` | Fund or investment manager name, for example Berkshire Hathaway. |
| `max_results` | integer | no | `5` | Maximum number of largest holdings to return, for example 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "investor"
  ],
  "properties": {
    "quarter": {
      "type": "string",
      "default": "",
      "description": "Reporting quarter, for example 2026 Q2. Defaults to the latest available.",
      "examples": [
        "2022 Q3",
        "2026 Q2"
      ]
    },
    "investor": {
      "type": "string",
      "description": "Fund or investment manager name, for example Berkshire Hathaway.",
      "examples": [
        "Berkshire Hathaway"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum number of largest holdings to return, for example 50.",
      "x-fous-developer": true,
      "examples": [
        5,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "quarter": "2022 Q3",
      "investor": "Berkshire Hathaway",
      "max_results": 5
    },
    {
      "investor": "Berkshire Hathaway"
    },
    {
      "quarter": "2026 Q2",
      "investor": "Berkshire Hathaway",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cik` | string | `"0001067983"` |  |
| `holdings` | array |  |  |
| `holdings[].link` | string | `"https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/18337.xml"` | SEC page for the holding’s filing table. |
| `holdings[].cusip` | string or null | `"037833100"` | SEC security identifier. |
| `holdings[].status` | string or null | `"unchanged"` | Position change from the prior quarter. |
| `holdings[].value_usd` | number | `123661679000` | Reported market value in US dollars. |
| `holdings[].share_class` | string or null | `"COM"` | Reported class of security. |
| `holdings[].shares_held` | number or null | `894802319` | Shares held (null for principal-amount positions). |
| `holdings[].company_name` | string | `"APPLE INC"` | Company that issued the security. |
| `holdings[].percent_of_portfolio` | number or null | `41.763959` | Percentage of the reported portfolio value. |
| `holdings[].share_change_since_last_quarter` | number or null | `0` | Change in shares from the prior quarter, if available. |
| `filing_date` | string | `"2022-11-14"` |  |
| `filing_link` | string | `"https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/0000950123-22-012275-index.htm"` |  |
| `investor_name` | string | `"Berkshire Hathaway Inc"` |  |
| `quarter_end_date` | string | `"2022-09-30"` |  |
| `number_of_holdings` | integer | `49` |  |
| `total_portfolio_value_usd` | number | `296096640000` |  |

**Example input**

```json
{
  "quarter": "2022 Q3",
  "investor": "Berkshire Hathaway",
  "max_results": 5
}
```

**Example output**

```json
{
  "cik": "0001067983",
  "holdings": [
    {
      "link": "https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/18337.xml",
      "cusip": "037833100",
      "status": "unchanged",
      "value_usd": 123661679000,
      "share_class": "COM",
      "shares_held": 894802319,
      "company_name": "APPLE INC",
      "percent_of_portfolio": 41.763959,
      "share_change_since_last_quarter": 0
    },
    {
      "link": "https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/18337.xml",
      "cusip": "060505104",
      "status": "unchanged",
      "value_usd": 30505039000,
      "share_class": "COM",
      "shares_held": 1010100606,
      "company_name": "BANK AMER CORP",
      "percent_of_portfolio": 10.302393,
      "share_change_since_last_quarter": 0
    },
    {
      "link": "https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/18337.xml",
      "cusip": "166764100",
      "status": "increased",
      "value_usd": 23757173000,
      "share_class": "COM",
      "shares_held": 165359318,
      "company_name": "CHEVRON CORP NEW",
      "percent_of_portfolio": 8.023452,
      "share_change_since_last_quarter": 3919169
    }
  ],
  "filing_date": "2022-11-14",
  "filing_link": "https://www.sec.gov/Archives/edgar/data/1067983/000095012322012275/0000950123-22-012275-index.htm",
  "investor_name": "Berkshire Hathaway Inc",
  "quarter_end_date": "2022-09-30",
  "number_of_holdings": 49,
  "total_portfolio_value_usd": 296096640000
}
```

### List insider trades

Operation `list_insider_trades`, version 1. 1 credit per call.

List reported stock transactions by a company’s officers, directors, and major owners from Form 4 filings, newest first. Returns up to 200 records; trades without a reported price have no calculated value.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"AAPL"` | Company name or stock ticker, for example Nvidia or NVDA. |
| `start_date` | string | no | `"2026-09-01"` | Earliest trade date to include, such as 2026-06-30; defaults to 90 days ago. |
| `trade_type` | string | no | `"purchases"` | Show any reported transaction, only purchases, or only sales; for example sales. |
| `max_results` | integer | no | `10` | Maximum number of trades, from 1 to 200; for example 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company name or stock ticker, for example Nvidia or NVDA.",
      "examples": [
        "AAPL",
        "Nvidia",
        "NVDA"
      ]
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest trade date to include, such as 2026-06-30; defaults to 90 days ago.",
      "examples": [
        "2026-09-01"
      ]
    },
    "trade_type": {
      "enum": [
        "any",
        "purchases",
        "sales"
      ],
      "type": "string",
      "default": "any",
      "description": "Show any reported transaction, only purchases, or only sales; for example sales.",
      "examples": [
        "purchases",
        "sales",
        "any"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of trades, from 1 to 200; for example 50.",
      "x-fous-developer": true,
      "examples": [
        10,
        15,
        200
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "AAPL",
      "trade_type": "purchases",
      "max_results": 10
    },
    {
      "company": "Nvidia",
      "trade_type": "sales",
      "max_results": 10
    },
    {
      "company": "Nvidia",
      "start_date": "2026-09-01",
      "trade_type": "any",
      "max_results": 15
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `cik` | string | `"0000320193"` | Issuer CIK assigned by the SEC. |
| `trades` | array |  |  |
| `trades[].role` | string or null | `"EVP, General Counsel and Sec"` | Reported position or ownership relationship. |
| `trades[].shares` | number or null | `12483` |  |
| `trades[].trade_date` | string | `"2026-09-21"` |  |
| `trades[].trade_type` | string | `"sale"` |  |
| `trades[].filing_date` | string | `"2026-09-23"` |  |
| `trades[].form_4_link` | string | `"https://www.sec.gov/Archives/edgar/data/1045810/000169684126000014/0001696841-26-000014-index.html"` |  |
| `trades[].insider_name` | string | `"Teter Timothy S."` | Name of the reporting insider. |
| `trades[].total_value_usd` | number or null | `2773637.72` | Shares times the reported per-share price, in USD, when both are available. |
| `trades[].accession_number` | string | `"0001696841-26-000014"` | Accession number of the Form 4 filing. |
| `trades[].transaction_code` | string or null | `"S"` | SEC transaction code, such as S or P. |
| `trades[].price_per_share_usd` | number or null | `222.1932` | Reported price per share in USD, when provided. |
| `trades[].shares_owned_after_trade` | number or null | `2705637` |  |
| `company_name` | string | `"Apple Inc."` |  |

**Example input**

```json
{
  "company": "AAPL",
  "trade_type": "purchases",
  "max_results": 10
}
```

**Example output**

```json
{
  "cik": "0000320193",
  "trades": [],
  "company_name": "Apple Inc."
}
```

### Search filings

Operation `search_filings`, version 1. 1 credit per call.

Find SEC EDGAR company filings that mention an exact phrase, ranked by search relevance. Results may include filing exhibits; excerpts are returned only when available.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `phrase` | string | yes | `"supply chain disruption"` | Exact words to find in filings, for example: supply chain disruption. |
| `company` | string | no | `"AAPL"` | Company name or ticker to limit matches, for example: Apple or AAPL. |
| `end_date` | string | no | `"2025-12-31"` | Last filing date, for example: 2026-09-28. Defaults to today. |
| `form_type` | string | no | `"current_report"` | Filing category, for example: annual_report. |
| `start_date` | string | no | `"2024-01-01"` | First filing date, for example: 2025-01-01. Defaults to one year ago; earliest is 2001-01-01. |
| `max_results` | integer | no | `5` | Maximum number of filings, for example: 20 (up to 100). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "phrase"
  ],
  "properties": {
    "phrase": {
      "type": "string",
      "minLength": 1,
      "description": "Exact words to find in filings, for example: supply chain disruption.",
      "examples": [
        "supply chain disruption",
        "risk factors",
        "utterlyuncommonfilingphraseqwerty2026"
      ]
    },
    "company": {
      "type": "string",
      "default": "",
      "description": "Company name or ticker to limit matches, for example: Apple or AAPL.",
      "examples": [
        "AAPL",
        "Apple"
      ]
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Last filing date, for example: 2026-09-28. Defaults to today.",
      "examples": [
        "2025-12-31"
      ]
    },
    "form_type": {
      "enum": [
        "any",
        "annual_report",
        "quarterly_report",
        "current_report",
        "proxy_statement",
        "registration"
      ],
      "type": "string",
      "default": "any",
      "description": "Filing category, for example: annual_report.",
      "examples": [
        "current_report",
        "annual_report"
      ]
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "First filing date, for example: 2025-01-01. Defaults to one year ago; earliest is 2001-01-01.",
      "examples": [
        "2024-01-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of filings, for example: 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        5,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "phrase": "supply chain disruption",
      "form_type": "current_report",
      "max_results": 5
    },
    {
      "phrase": "risk factors",
      "company": "AAPL",
      "end_date": "2025-12-31",
      "form_type": "annual_report",
      "start_date": "2024-01-01",
      "max_results": 3
    },
    {
      "phrase": "utterlyuncommonfilingphraseqwerty2026",
      "company": "Apple",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `filings` | array |  | Company filings ranked by phrase relevance. |
| `filings[].cik` | string | `"0000807882"` | SEC company identification number. |
| `filings[].form_type` | string or null | `"8-K"` | SEC filing form code, such as 10-K. |
| `filings[].filing_date` | string or null | `"2025-12-23"` | Date the filing was filed. |
| `filings[].company_name` | string or null | `"JACK IN THE BOX INC"` | Name of the filing company. |
| `filings[].form_meaning` | string or null | `"Current report"` | Plain-language meaning of the filing form. |
| `filings[].document_link` | string | `"https://www.sec.gov/Archives/edgar/data/807882/000080788225000081/ex991-pressreleasexdeltaco.htm"` | Link to the matching filing document. |
| `filings[].accession_number` | string | `"0000807882-25-000081"` | SEC filing accession number. |
| `filings[].report_period_date` | string or null | `"2025-12-22"` | Period date covered by the filing, if provided. |
| `filings[].matching_text_excerpt` | string or null |  | Matching text excerpt when supplied by EDGAR. |

**Example input**

```json
{
  "phrase": "supply chain disruption",
  "form_type": "current_report",
  "max_results": 5
}
```

**Example output**

```json
{
  "filings": [
    {
      "cik": "0000807882",
      "form_type": "8-K",
      "filing_date": "2025-12-23",
      "company_name": "JACK IN THE BOX INC",
      "form_meaning": "Current report",
      "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788225000081/ex991-pressreleasexdeltaco.htm",
      "accession_number": "0000807882-25-000081",
      "report_period_date": "2025-12-22",
      "matching_text_excerpt": null
    },
    {
      "cik": "0000807882",
      "form_type": "8-K",
      "filing_date": "2026-06-15",
      "company_name": "JACK IN THE BOX INC",
      "form_meaning": "Current report",
      "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788226000075/ex991-pressreleasexdebtpri.htm",
      "accession_number": "0000807882-26-000075",
      "report_period_date": "2026-06-12",
      "matching_text_excerpt": null
    },
    {
      "cik": "0000807882",
      "form_type": "8-K",
      "filing_date": "2026-06-23",
      "company_name": "JACK IN THE BOX INC",
      "form_meaning": "Current report",
      "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788226000079/ex991-pressreleasexdebtclo.htm",
      "accession_number": "0000807882-26-000079",
      "report_period_date": "2026-06-23",
      "matching_text_excerpt": null
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@sec-edgar",
  "visibility": "public",
  "operation": "get_company_filings",
  "version": 1,
  "input": {
    "company": "TSLA",
    "end_date": "2025-12-31",
    "start_date": "2025-01-01",
    "filing_type": "quarterly_report",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@sec-edgar\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_company_filings\",\n  \"version\": 1,\n  \"input\": {\n    \"company\": \"TSLA\",\n    \"end_date\": \"2025-12-31\",\n    \"start_date\": \"2025-01-01\",\n    \"filing_type\": \"quarterly_report\",\n    \"max_results\": 5\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@sec-edgar",
  "visibility": "public",
  "operation": "get_company_filings",
  "version": 1,
  "input": {
    "company": "TSLA",
    "end_date": "2025-12-31",
    "start_date": "2025-01-01",
    "filing_type": "quarterly_report",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@sec-edgar","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## FAQ

### Is Fous affiliated with SEC EDGAR?

No. Fous is not affiliated with SEC EDGAR. This workflow reads the public sec.gov website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a SEC EDGAR account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from sec.gov when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

## Related

- [Finviz API](https://fous.com/workflows/finviz.md): Finviz provides delayed US stock snapshots, screening by company and trading criteria, and up to 200 recent public executive and director Form 4 trades.
- [Yahoo Finance API](https://fous.com/workflows/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Google Finance API](https://fous.com/workflows/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [Stock Analysis API](https://fous.com/workflows/stock-analysis.md): Stock Analysis returns free-period company statements, statistics current as of its displayed date, typically top-25 ETF holdings, and US IPOs since 2019 with potentially missing prices or returns.
- [Nasdaq API](https://fous.com/workflows/nasdaq.md): Nasdaq provides market activity, scheduled earnings by date with fiscal quarter-end month, monthly US IPO listings, and dated ex-dividend entries; dividend histories cover Nasdaq-listed stocks only.
- [Companies House API](https://fous.com/workflows/companies-house.md): Companies House returns UK public-register company details, officers, people with significant control and recent filings; records may be incomplete, and ceased entries are optional.
- [Capitol Trades API](https://fous.com/workflows/capitol-trades.md): Capitol Trades shows disclosed US congressional stock trades, with up to three years of history; recent trades are newest first and can be filtered.
- [Macrotrends API](https://fous.com/workflows/macrotrends.md): Macrotrends provides long-term financial and economic charts, company metric histories, and yearly commodity and index prices; current-year prices may be incomplete.
- [All Finance workflows](https://fous.com/workflows/category/finance)