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/tickers/AAPL/income?period=quarterly&api_key=YOUR_API_KEY"

FREE

50 tickers with no API key

AAPLMSFTGOOGLAMZNMETANVDATSLAJPMVMAWMTJNJPGHDBACKOPEPABBVMRKCOSTAVGOORCLCRMNFLXADBEAMDINTCQCOMTXNCSCOIBMNOWINTUNETDDOGSNOWUBERSHOPPYPLRBLXOKTAMCDDISXOMCVXGECATUNH

Endpoints

GET/v1/tickers/: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/tickers/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/tickers/: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/tickers/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/tickers/: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/tickers/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). Format: YYYY-MM-DD.

line_items[].conceptstringNormalized GAAP concept key (see Concept Reference below).

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 for that period.

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. Currency values are raw dollars.

Errors

All errors return JSON with an error field. A ticker with no data yet returns HTTP 200 with empty periods and line_items arrays.

400{"error": "period must be quarterly or annual"}Invalid period parameter value.

401{"error": "api_key required for this ticker"}Ticker requires an API key — not in the free list.

200{"ticker": "XYZ", "periods": [], "line_items": []}Ticker not found or no filings parsed yet.

Concept Reference

All possible values of line_items[].concept per endpoint. Not all concepts appear for every company — a concept is only present if the company reported it. Negative values (e.g. capital_expenditures, repurchase_common_stock) represent cash outflows.

Income Statement — /income

Financial-sector companies (banks, insurers) have additional concepts.

Standard

revenuesTotal net revenue / sales

cost_of_revenueCost of goods sold / cost of revenue

gross_profitRevenue minus cost of revenue

research_developmentR&D expense

selling_general_administrativeSG&A expense

operating_expensesTotal operating expenses

operating_incomeOperating income / EBIT

nonoperating_incomeOther non-operating income

interest_expenseInterest expense

pretax_incomeIncome before tax

income_taxIncome tax expense

net_incomeNet income attributable to shareholders

eps_basicBasic EPS (format: per_share)

eps_dilutedDiluted EPS (format: per_share)

shares_basicBasic weighted-average shares (format: shares)

shares_dilutedDiluted weighted-average shares (format: shares)

Financial sector only

interest_incomeTotal interest income

net_interest_incomeNet interest income

provision_credit_lossesProvision for credit losses

net_interest_income_after_provisionNet interest income after provision

noninterest_incomeNon-interest income

trading_revenueTrading revenue

investment_banking_revenueInvestment banking revenue

brokerage_commissionsBrokerage commissions

noninterest_expenseNon-interest expense

Balance Sheet — /balance

Values as of the period-end date.

Assets

total_assetsTotal assets

current_assetsTotal current assets

cash_equivalentsCash and cash equivalents

short_term_investmentsShort-term investments

accounts_receivableAccounts receivable, net

inventoryInventory

other_current_assetsOther current assets

noncurrent_assetsTotal non-current assets

ppe_netProperty, plant & equipment, net

goodwillGoodwill

intangiblesIntangible assets, net

other_noncurrent_assetsOther non-current assets

Liabilities

total_liabilitiesTotal liabilities

current_liabilitiesTotal current liabilities

accounts_payableAccounts payable

accrued_liabilitiesAccrued liabilities

deferred_revenue_currentDeferred revenue (current)

current_debtShort-term debt / current portion of long-term debt

noncurrent_liabilitiesTotal non-current liabilities

long_term_debtLong-term debt

deferred_revenue_noncurrentDeferred revenue (non-current)

other_noncurrent_liabilitiesOther non-current liabilities

Equity

stockholders_equityTotal stockholders' equity

common_stockCommon stock

additional_paid_in_capitalAdditional paid-in capital

retained_earningsRetained earnings (accumulated deficit)

aociAccumulated other comprehensive income / loss

Cash Flow Statement — /cashflow

Quarterly values represent the single quarter, not YTD.

Operating

operating_cash_flowNet cash from operating activities

net_incomeNet income (reconciliation start)

depreciation_amortizationDepreciation and amortization

stock_based_compensationStock-based compensation

change_accounts_receivableChange in accounts receivable

change_inventoriesChange in inventories

change_accounts_payableChange in accounts payable

change_deferred_revenueChange in deferred revenue

change_other_operating_assetsChange in other operating assets

change_other_operating_liabilitiesChange in other operating liabilities

Investing

investing_cash_flowNet cash from investing activities

capital_expendituresCapital expenditures (negative = outflow)

acquisitionsAcquisitions, net of cash

purchases_investmentsPurchases of investments

proceeds_investmentsProceeds from sale of investments

proceeds_ppeProceeds from sale of property/equipment

Financing

financing_cash_flowNet cash from financing activities

proceeds_issuance_stockProceeds from issuance of stock

repurchase_common_stockRepurchase of common stock (negative)

dividends_paidDividends paid (negative)

proceeds_long_term_debtProceeds from long-term debt

repayments_debtRepayments of debt

Summary

net_change_cashNet change in cash and equivalents