# SEC EDGAR API: Get company financials

> Looks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.

Unofficial. Not affiliated with or endorsed by SEC EDGAR.

- Page: https://fous.com/methods/sec.gov/get-company-financials
- Method: `sec.gov/get_company_financials`, version 1
- Website: sec.gov
- Returns: company name, currency, CIK, and per-period revenue, net income, EPS, balance sheet, cash flow, shares and filing references
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

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

## Output

From a run on Oct 23, 2026, shortened. Its input:

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

Its 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
    },
    {
      "cash": 24296000000,
      "quarter": 2,
      "revenue": 81273000000,
      "net_income": 38458000000,
      "fiscal_year": 2026,
      "total_assets": 665302000000,
      "period_end_date": "2025-12-31",
      "accession_number": "0001193125-26-027207",
      "total_liabilities": 274427000000,
      "shares_outstanding": 7429000000,
      "source_filing_date": "2026-01-28",
      "source_filing_form": "10-Q",
      "source_filing_link": "https://www.sec.gov/Archives/edgar/data/789019/000119312526027207/",
      "operating_cash_flow": 35758000000,
      "stockholders_equity": 390875000000,
      "diluted_earnings_per_share": 5.16
    }
  ],
  "currency": "USD",
  "company_name": "Microsoft Corporation"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"sec.gov/get_company_financials","input":{"years":2,"period":"quarterly","company":"MSFT"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Pull the last 5 years of annual financials for Microsoft from SEC filings
- What were Apple's quarterly revenue and net income figures for the most recent quarters?
- Get EPS and balance sheet data for Tesla over the past 3 fiscal years
- Show me NVDA's reported cash flow and shares outstanding on sec.gov for the last 10 years
- Can you find Coca-Cola's quarterly earnings figures from EDGAR, including filing references?

## 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."
    },
    "period": {
      "enum": [
        "annual",
        "quarterly"
      ],
      "type": "string",
      "default": "annual",
      "description": "Reporting frequency, for example annual."
    },
    "company": {
      "type": "string",
      "description": "Company name or stock ticker, for example Microsoft or MSFT."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "company_name",
    "currency",
    "cik",
    "periods"
  ],
  "properties": {
    "cik": {
      "type": "string",
      "x-fous-developer": true
    },
    "periods": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "fiscal_year",
          "quarter",
          "period_end_date",
          "revenue",
          "net_income",
          "diluted_earnings_per_share",
          "total_assets",
          "total_liabilities",
          "stockholders_equity",
          "cash",
          "operating_cash_flow",
          "shares_outstanding",
          "source_filing_form",
          "source_filing_date",
          "source_filing_link",
          "accession_number"
        ],
        "properties": {
          "cash": {
            "type": [
              "number",
              "null"
            ]
          },
          "quarter": {
            "type": [
              "integer",
              "null"
            ]
          },
          "revenue": {
            "type": [
              "number",
              "null"
            ]
          },
          "net_income": {
            "type": [
              "number",
              "null"
            ]
          },
          "fiscal_year": {
            "type": "integer"
          },
          "total_assets": {
            "type": [
              "number",
              "null"
            ]
          },
          "period_end_date": {
            "type": "string",
            "format": "date"
          },
          "accession_number": {
            "type": "string",
            "x-fous-developer": true
          },
          "total_liabilities": {
            "type": [
              "number",
              "null"
            ]
          },
          "shares_outstanding": {
            "type": [
              "number",
              "null"
            ]
          },
          "source_filing_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "source_filing_form": {
            "type": "string"
          },
          "source_filing_link": {
            "type": "string"
          },
          "operating_cash_flow": {
            "type": [
              "number",
              "null"
            ]
          },
          "stockholders_equity": {
            "type": [
              "number",
              "null"
            ]
          },
          "diluted_earnings_per_share": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    },
    "currency": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    }
  }
}
```

## See more

- [SEC EDGAR API: List company SEC filings](https://fous.com/methods/sec.gov/get-company-filings.md): Finds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date.
- [SEC EDGAR API: Search filings by phrase](https://fous.com/methods/sec.gov/search-filings.md): Finds SEC EDGAR company filings that mention an exact phrase, optionally limited to a company, a filing category and a filing date range, ranked by search relevance; one entry per filing.
- [SEC EDGAR API: List insider trades](https://fous.com/methods/sec.gov/list-insider-trades.md): Lists stock transactions reported on Form 4 filings by a company's officers, directors and major owners, newest first. Trades without a reported price have no calculated value.
- [Google API: Get company financials](https://fous.com/methods/google.com/get-company-financials.md): Gets a company's quarterly or annual income statement, balance sheet or cash flow lines from its Google Finance quote page, with exact reported amounts and year-over-year changes.
- [Stock Analysis API: Get financial statements](https://fous.com/methods/stockanalysis.com/get-financial-statements.md): Looks up a company by name or ticker on Stock Analysis and returns its annual or quarterly income statement, balance sheet, or cash flow statement for the free periods.
- [Stock Analysis API: Get key statistics](https://fous.com/methods/stockanalysis.com/get-key-statistics.md): Looks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated.
- [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
- [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
- [All SEC EDGAR methods](https://fous.com/methods/sec.gov.md)