REST API · v1

API Reference

Structured SEC financial data for income statements, balance sheets, and cash flows — parsed from EDGAR filings and returned as clean JSON.

Base URL

https://api.edgarparse.com/v1

API Keys

Pass your API key as the api_key query parameter. The 50 tickers listed below are free — no key required, returns 8 quarters or 3 annual periods. A free key unlocks all tickers at the same data limits. A paid key unlocks full history. Get your key from your profile.

bash

curl "https://api.edgarparse.com/v1/AAPL/income?period=quarterly&api_key=YOUR_API_KEY"

FREE

50 tickers with no API key

AAPLMSFTGOOGLAMZNMETANVDATSLAJPMVMAWMTJNJPGHDBACKOPEPABBVMRKCOSTAVGOORCLCRMNFLXADBEAMDINTCQCOMTXNCSCOIBMNOWINTUNETDDOGSNOWUBERSHOPPYPLRBLXOKTAMCDDISXOMCVXGECATUNH

Endpoints

GET/v1/:ticker/income

Income Statement

Returns revenue, gross profit, operating income, net income, EPS, and share counts across all filed periods.

Parameters

tickerrequired

pathStock ticker symbol (e.g. AAPL)

period

queryquarterly (default) or annual

api_key

queryAPI key from your profile. Without a key only free tickers are accessible (8 quarters / 3 annual). Free key: all tickers, same limits. Paid key: all tickers, full history.

Example request

bash

curl "https://api.edgarparse.com/v1/AAPL/income?period=quarterly&api_key=YOUR_API_KEY"

Response

json

{
  "ticker": "AAPL",
  "period": "quarterly",
  "periods": ["2026-03-28", "2025-12-27", "2025-06-28", ...],
  "line_items": [
    { "concept": "revenues",     "label": "net revenue", "values": [111184000000, ...], "is_bold": false, "format": "currency"  },
    { "concept": "gross_profit", "label": "gross profit","values": [54781000000,  ...], "is_bold": true,  "format": "currency"  },
    { "concept": "net_income",   "label": "net income",  "values": [29578000000,  ...], "is_bold": true,  "format": "currency"  },
    { "concept": "eps_diluted",  "label": "EPS diluted", "values": [2.01, ...],          "is_bold": false, "format": "per_share" }
  ]
}

GET/v1/:ticker/balance

Balance Sheet

Returns total assets, liabilities, equity, cash, debt, receivables, and other balance sheet items.

Parameters

tickerrequired

pathStock ticker symbol

period

queryquarterly (default) or annual

api_key

queryAPI key from your profile. See /income for tier details.

Example request

bash

curl "https://api.edgarparse.com/v1/MSFT/balance?period=annual&api_key=YOUR_API_KEY"

Response

json

{
  "ticker": "MSFT",
  "period": "annual",
  "periods": ["2024-06-30", "2023-06-30", "2022-06-30", ...],
  "line_items": [
    { "concept": "total_assets",        "label": "total assets",        "values": [512163000000, ...], "is_bold": true,  "format": "currency" },
    { "concept": "cash_equivalents",    "label": "cash and equivalents","values": [18315000000,  ...], "is_bold": false, "format": "currency" },
    { "concept": "total_liabilities",   "label": "total liabilities",   "values": [243686000000, ...], "is_bold": true,  "format": "currency" },
    { "concept": "stockholders_equity", "label": "stockholders equity", "values": [268477000000, ...], "is_bold": true,  "format": "currency" }
  ]
}

GET/v1/:ticker/cashflow

Cash Flow Statement

Returns operating, investing, and financing cash flows, capex, stock buybacks, dividends, and net change in cash.

Parameters

tickerrequired

pathStock ticker symbol

period

queryquarterly (default) or annual

api_key

queryAPI key from your profile. See /income for tier details.

Example request

bash

curl "https://api.edgarparse.com/v1/NVDA/cashflow?period=quarterly&api_key=YOUR_API_KEY"

Response

json

{
  "ticker": "NVDA",
  "period": "quarterly",
  "periods": ["2025-01-26", "2024-10-27", "2024-07-28", ...],
  "line_items": [
    { "concept": "operating_cash_flow",  "label": "operating cash flow", "values": [19396000000, ...], "is_bold": true,  "format": "currency" },
    { "concept": "capital_expenditures", "label": "capital expenditures","values": [-397000000,  ...], "is_bold": false, "format": "currency" },
    { "concept": "financing_cash_flow",  "label": "financing cash flow", "values": [-12082000000,...], "is_bold": true,  "format": "currency" },
    { "concept": "net_change_cash",      "label": "net change in cash",  "values": [6929000000,  ...], "is_bold": true,  "format": "currency" }
  ]
}

GET/free-tickers

Free Tickers

Returns the list of tickers accessible without an API key.

Parameters

Example request

bash

curl "https://api.edgarparse.com/free-tickers"

Response

json

{
  "tickers": ["AAPL", "MSFT", "GOOGL", ...]
}

GET/all-tickers

All Tickers

Returns the full list of tickers currently tracked by EdgarParse.

Parameters

Example request

bash

curl "https://api.edgarparse.com/all-tickers"

Response

json

{
  "tickers": ["AAPL", "MSFT", "GOOGL", ..., "TSLA", ...]
}

Response field reference

periodsstring[]Period-end dates in descending order (most recent first).

line_items[].conceptstringNormalized GAAP concept key (e.g. revenue, net_income).

line_items[].labelstringHuman-readable label from the original filing.

line_items[].values(number|null)[]One value per period, aligned to the periods array. null = not reported.

line_items[].is_boldbooleantrue for key subtotals and totals — useful for table styling.

line_items[].formatstringcurrency | per_share | shares — how to format the value for display.