Hoppa till innehållet

API referens

Varje rutt i API, läst från det OpenAPI dokumentet. Varje har en exempelförfrågan från ett verkligt företag. Den interaktiva referensen kör samma anrop i webbläsaren.

GET /v1/companies

Search or page the company directory. Use it to turn a name into a company id, or to list every company with a dataset. Each item has fmd_id, cik, primary_ticker, registry, lei and available_datasets. Issuers on EU and UK regulated markets are listed with registry=esef and no CIK: filter them with registry=esef or country=FR, and pass company=lei:<LEI> to the company routes.

Example: GET https://api.financial.md/v1/companies?q=Apple&limit=5

ParameterInDescription
qqueryName or ticker search (names as substring, tickers as prefix; case-insensitive)
countryqueryISO 3166-1 alpha-2
registryqueryThe regulator the statements are read from: sec, or esef for issuers on EU and UK regulated markets
exchangequeryMIC of a listing, e.g. XNAS
templatequeryReporting template
statusqueryCompany status
updated_sincequeryCompanies updated since this date or timestamp
limitqueryMaximum companies per page
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/companies?q=Apple&limit=5"

GET /v1/company/profile

One company's identity: CIK, listings with exchange codes, sector, industry, reporting template, fiscal year end and which datasets are served. Call it first when you are unsure a ticker is covered. registry names the regulator the statements come from, reporting_currency the currency every value is served in (never converted), and registrations every regulator the company is known at.

Example: GET https://api.financial.md/v1/company/profile?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
curl "https://api.financial.md/v1/company/profile?company=ticker:AAPL"

GET /v1/company/financials/{statement}/standardized

A financial statement on the FinancialMD template, so line items compare across companies. Use it for questions such as "What was Apple's revenue in fiscal 2024?" or "What is AAPL's free cash flow?". data.periods is most recent first and row.cells[i] is the value object for periods[i], each with the 10-K or 10-Q it came from. Add as_of for what was known on a date, original=true for first-reported values, history=true for every restatement.

Example: GET https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5

ParameterInDescription
statement (required)pathStatement; supplemental carries share counts and per-share figures
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
period_typequeryPeriod type
limitqueryMaximum periods (most recent first)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
originalqueryFirst-reported version of each period
historyqueryEvery knowledge version of each period, oldest first
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"

GET /v1/company/financials/{statement}/as_reported

The same grid with the filer's own line items: one row per XBRL tag and dimension as filed. Use it when you need the company's exact label or a line the template folds into a total.

Example: GET https://api.financial.md/v1/company/financials/balance_sheet/as_reported?company=cik:320193&period_type=annual&limit=2

ParameterInDescription
statement (required)pathStatement
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
period_typequeryPeriod type (as-reported serves annual, quarterly and half-year facts; balance sheets are instants at the period end)
limitqueryMaximum periods
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
historyqueryEvery filing's version of each line and period, oldest first
accessionqueryOnly facts from this filing
curl "https://api.financial.md/v1/company/financials/balance_sheet/as_reported?company=cik:320193&period_type=annual&limit=2"

GET /v1/company/ratios

Margins, returns, leverage, liquidity, growth and per-share ratios for each period, computed from the standardized facts. Each ratio carries the proof ids of its inputs, so it can be traced to the filing.

Example: GET https://api.financial.md/v1/company/ratios?company=ticker:AAPL&period_type=annual&limit=5

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
period_typequeryPeriod type
limitqueryMaximum periods (most recent first)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/ratios?company=ticker:AAPL&period_type=annual&limit=5"

GET /v1/company/ratios/daily/{ratio_id}

One ratio as a series. Fundamental ratios have one point per fiscal period; valuation ratios (market cap, P/E, EV/EBITDA and others) have one point per trading session, pairing the IEX close with the facts known that evening.

Example: GET https://api.financial.md/v1/company/ratios/daily/gross_margin?company=ticker:AAPL&period_type=annual&limit=10

ParameterInDescription
ratio_id (required)pathRatio id from GET /v1/company/metrics?statement=ratios
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
period_typequeryPeriod type
limitqueryMaximum periods (most recent first); sessions for a valuation ratio
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
tickerqueryValuation ratios: the listing whose close is used
fromqueryValuation ratios: first session, inclusive
toqueryValuation ratios: last session, inclusive
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/ratios/daily/gross_margin?company=ticker:AAPL&period_type=annual&limit=10"

GET /v1/company/metrics

The concept ids, labels, display order and subtotal formulas of the company's template. Use the ids in /v1/screen, /v1/verify and to read statement rows. statement=ratios lists the ratio ids and formulas.

Example: GET https://api.financial.md/v1/company/metrics?company=ticker:AAPL&statement=income_statement

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
statementqueryOnly this statement; ratios lists the serve-time ratios with their formulas
curl "https://api.financial.md/v1/company/metrics?company=ticker:AAPL&statement=income_statement"

GET /v1/company/filings

A company's SEC filings, newest first, with accession number, form, period and filing date and an EDGAR link.

Example: GET https://api.financial.md/v1/company/filings?company=ticker:AAPL&form=10-K&limit=5

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
formqueryForm type, e.g. 10-K
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum filings
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/filings?company=ticker:AAPL&form=10-K&limit=5"

GET /v1/filing/{accession}

One filing by accession number: form, fiscal period, filing and acceptance times, primary document and EDGAR link.

Example: GET https://api.financial.md/v1/filing/0000320193-24-000123

ParameterInDescription
accession (required)pathAccession number, e.g. 0000320193-24-000123
curl "https://api.financial.md/v1/filing/0000320193-24-000123"

GET /v1/filing/{accession}/document

Links to every document of a filing on EDGAR; index_url and document_url are always sent, also when no PDF is rendered. format=html returns the primary document itself, format=pdf the same document printed to pages with selectable text, format=pages its page count, and format=png&page=N one page as an image to cite.

Example: GET https://api.financial.md/v1/filing/0000320193-24-000123/document

ParameterInDescription
accession (required)pathAccession number
formatqueryjson: the links. html: the primary document as EDGAR serves it (relative links resolve to EDGAR). pdf: the primary document printed to US Letter pages, with selectable text. pages: the PDF's page count and its links, as JSON. png: one page of the PDF as an image (needs page)
pagequeryWith format=png: the page to return, from 1 to the page count that format=pages and the X-FMD-Page-Count header give
curl "https://api.financial.md/v1/filing/0000320193-24-000123/document"

GET /v1/filing/{accession}/facts

Every fact one filing tagged that maps to a statement concept, grouped by statement, in one call. Use it to read what a single 10-K or 10-Q said.

Example: GET https://api.financial.md/v1/filing/0000320193-24-000123/facts?statement=income_statement

ParameterInDescription
accession (required)pathAccession number
statementqueryOnly this statement
limitqueryMaximum facts
curl "https://api.financial.md/v1/filing/0000320193-24-000123/facts?statement=income_statement"

GET /v1/company/ownership/insiders

Insider transactions from Forms 3, 4 and 5, newest first: who, role, transaction code, shares, price and the filing.

Example: GET https://api.financial.md/v1/company/ownership/insiders?company=ticker:AAPL&limit=20

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum transactions
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/ownership/insiders?company=ticker:AAPL&limit=20"

GET /v1/company/ownership/institutional

Form 13F managers that reported a position in the company for a quarter, with shares, value and the change against the prior quarter.

Example: GET https://api.financial.md/v1/company/ownership/institutional?company=ticker:AAPL&limit=20

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
periodqueryCalendar quarter end the holdings are reported for
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum positions
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/ownership/institutional?company=ticker:AAPL&limit=20"

GET /v1/ownership/institutional/holders

Search Form 13F managers by name. Each has a CIK to pass to /v1/ownership/institutional/holdings.

Example: GET https://api.financial.md/v1/ownership/institutional/holders?q=Berkshire

ParameterInDescription
qqueryManager name search (case-insensitive substring)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum managers
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/ownership/institutional/holders?q=Berkshire"

GET /v1/ownership/institutional/holdings

One Form 13F manager's portfolio for a quarter, largest positions first.

Example: GET https://api.financial.md/v1/ownership/institutional/holdings?holder=cik:1067983&period=2026-06-30&limit=20

ParameterInDescription
holder (required)queryThe manager's SEC CIK
periodqueryCalendar quarter end the holdings are reported for
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum positions
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/ownership/institutional/holdings?holder=cik:1067983&period=2026-06-30&limit=20"

GET /v1/company/stock_prices

Daily bars built from trades at IEX only. This is not the consolidated tape and the close is not the official close. adjust=splits adds split-adjusted values; adjust=total_return adds dividend-reinvested values.

Example: GET https://api.financial.md/v1/company/stock_prices?company=ticker:AAPL&from=2026-10-01&to=2026-10-31

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
tickerqueryOne of the company's listings; default is the ticker named in company, else the primary listing with bars
fromqueryFirst session, inclusive
toqueryLast session, inclusive
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum sessions
cursorqueryOpaque cursor from meta.next_cursor
adjustquerysplits: each bar also carries split_adjusted values (confirmed splits after the session only); total_return: also total_return values (split-adjusted times the dividend factors of every ex-date after the session)
curl "https://api.financial.md/v1/company/stock_prices?company=ticker:AAPL&from=2026-10-01&to=2026-10-31"

GET /v1/company/splits

Stock splits as filed in XBRL, each with whether IEX prices confirm it.

Example: GET https://api.financial.md/v1/company/splits?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/splits?company=ticker:AAPL"

GET /v1/company/dividends

Dividends per share declared or paid in each fiscal period, as filed, with proof.

Example: GET https://api.financial.md/v1/company/dividends?company=ticker:AAPL&limit=8

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
kindqueryOnly declared or only paid
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum periods
curl "https://api.financial.md/v1/company/dividends?company=ticker:AAPL&limit=8"

GET /v1/events_calendar

Earnings releases (8-K Item 2.02 filed) and model-expected report dates, for one company or for every company in a date range.

Example: GET https://api.financial.md/v1/events_calendar?company=ticker:AAPL

ParameterInDescription
companyqueryOptional: one company
fromqueryFirst date, inclusive
toqueryLast date, inclusive
confidencequeryconfirmed: 8-K Item 2.02 filed; predicted: cadence model
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum events
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/events_calendar?company=ticker:AAPL"

GET /v1/company/events

A company's 8-K filings with the items they report (earnings, leadership changes, agreements and others), newest first.

Example: GET https://api.financial.md/v1/company/events?company=ticker:AAPL&limit=10

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
event_typequeryOnly items of this type
importance_minqueryOnly filings whose highest item is at least this important
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum items
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/events?company=ticker:AAPL&limit=10"

GET /v1/news

8-K filings across every company, newest first, each with its items, event types, a headline and an importance from 1 to 5 (FinancialMD's rule by item number). importance_min=4 gives the top stories: earnings, M&A, impairments, auditor changes, restatements, bankruptcies. Built from EDGAR, not wire news.

Example: GET https://api.financial.md/v1/news?importance_min=4&limit=20

ParameterInDescription
companyqueryOptional: one company
event_typequeryOnly filings with an item of this type
importance_minqueryOnly filings whose highest item is at least this important (FinancialMD's rule by 8-K item; see note)
fromqueryAccepted on or after this date (UTC)
toqueryAccepted on or before this date (UTC)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum filings
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/news?importance_min=4&limit=20"

GET /v1/news/feed

FinancialMD's own event feed, built only from SEC filings as EDGAR accepts them: 8-K and 6-K, Schedule 13D and 13G, Rule 425, NT 10-K and NT 10-Q, S-1, and clusters of insider purchases. Each event has a type, an importance from 1 to 5 with the rule that set it, a headline made by rule from the filing's own facts (labelled, never a wire headline), key numbers with the passage they come from, and the filing link. Amendments fold under the original unless amendments=all. form takes one form or several separated by commas. Only companies of the company universe are in the feed; a registrant that has not listed yet is on /v1/pre_ipo.

Example: GET https://api.financial.md/v1/news/feed?importance_min=4&limit=20

ParameterInDescription
companyqueryOptional: one company
event_typequeryOnly events of this type
importance_minqueryOnly events at least this important (FinancialMD's rule; see note)
formqueryOnly events from this form, or from any of up to 12 forms separated by commas. Amendments are always included, so S-1 and S-1/A ask for the same events. The feed holds events of companies in the company universe only; a registrant that has not listed yet is on GET /v1/pre_ipo
amendmentsquerycollapse folds an amendment under its original (amended_by); all shows every filing
fromqueryAccepted on or after this date (UTC)
toqueryAccepted on or before this date (UTC)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum events
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/news/feed?importance_min=4&limit=20"

GET /v1/news/issuer_releases

Releases issuers publish about themselves, newest first: press and earnings releases filed as SEC exhibits (text readable as passages), and the headline, link and time from issuers' own feeds (no article body stored). No wire or publisher content.

Example: GET https://api.financial.md/v1/news/issuer_releases?company=ticker:AAPL&limit=10

ParameterInDescription
companyqueryOptional: one company
sourcequeryedgar: exhibits filed with the SEC. issuer_site: headline and link from the issuer's own feed
fromqueryPublished on or after this date (UTC)
toqueryPublished on or before this date (UTC)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum releases
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/news/issuer_releases?company=ticker:AAPL&limit=10"

GET /v1/company/call_materials

What a company itself filed with the SEC around its earnings calls: earnings releases, prepared remarks, shareholder letters, presentations and any transcript the issuer chose to file. Each document has its kind, period, whether it has a Q&A section, and a link. Not a complete transcript archive: most issuers do not file call transcripts.

Example: GET https://api.financial.md/v1/company/call_materials?company=ticker:AAPL&limit=10

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
kindqueryOnly documents of this kind
fromqueryAccepted on or after this date (UTC)
toqueryAccepted on or before this date (UTC)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum documents
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/call_materials?company=ticker:AAPL&limit=10"

GET /v1/call_material/{id}

One issuer-filed document as ordered passages: section (prepared remarks, Q&A, safe harbor), speaker, role, topic tags and character offsets. Filter by section, speaker or topic (topic=guidance finds the passages that talk about outlook). Text is null when the filed document carries another party's copyright notice; the link still works.

Example: GET https://api.financial.md/v1/call_material/doc_1?topic=guidance

ParameterInDescription
id (required)pathDocument id from /v1/company/call_materials or /v1/news/issuer_releases
sectionqueryOnly passages of this section
speakerqueryOnly passages whose speaker name contains this text
topicqueryOnly passages tagged with this topic
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum passages
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/call_material/doc_1?topic=guidance"

GET /v1/calls_calendar

Conference calls as issuers announce them in their own SEC filings: date, time as stated, fiscal period, and the issuer's own webcast page. Link and metadata only; no audio and no transcript.

Example: GET https://api.financial.md/v1/calls_calendar?company=ticker:AAPL

ParameterInDescription
companyqueryOptional: one company
fromqueryCalls on or after this date (default: a week before as_of)
toqueryCalls on or before this date (default: 97 days after from)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum calls
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/calls_calendar?company=ticker:AAPL"

GET /v1/politician_trades

Stock and other securities trades that members of the U.S. House reported in periodic transaction reports (PTRs), newest filing first. Each row carries the filer's own words under as_filed (owner, asset, type, dates, amount range), the official report at source_url with its retrieval time, and FinancialMD's own additions under financialmd (the matched company and a confidence). Handwritten reports are listed with parse_status unparsed and the link only, never guessed. The company filter matches high and medium confidence only. Every answer carries data.notice: 5 U.S.C. 13107(c)(1) limits your use of this data (no commercial use other than news media informing the public, no credit rating, no solicitation). This route is never priced. Senate reports are not loaded.

Example: GET https://api.financial.md/v1/politician_trades?company=ticker:NVDA&type=purchase&from=2026-01-01&limit=20

ParameterInDescription
companyqueryOptional: only trades FinancialMD matched to this company with high or medium confidence
memberqueryA member key from an earlier answer, or part of the filer's name
chamberqueryOnly this chamber (Senate reports are not loaded)
typequeryOnly this transaction type (sale also matches sale_partial)
fromqueryTransaction date on or after this date; with date_field=filing, the filing date
toqueryTransaction date on or before this date; with date_field=filing, the filing date
date_fieldqueryWhich date from and to apply to
include_unparsedqueryAlso list reports that could not be read (handwritten scans) as link-only entries in data.unparsed_filings
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum transactions
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/politician_trades?company=ticker:NVDA&type=purchase&from=2026-01-01&limit=20"

GET /v1/search/filings

Find the EDGAR documents (filings and exhibits since 2001) that contain words or a quoted phrase, through SEC EDGAR full-text search. Each hit names its filing, form, date and companies with FinancialMD ids, and links the document.

Example: GET https://api.financial.md/v1/search/filings?q=%22going%20concern%22&forms=10-K&limit=10

ParameterInDescription
q (required)queryWords to find; a phrase in double quotes matches exactly
formsqueryComma-separated form types
companyqueryOptional: only this company's documents
fromqueryFiled on or after
toqueryFiled on or before
pagequeryPage number, 1-based
limitqueryMaximum documents per page
curl "https://api.financial.md/v1/search/filings?q=%22going%20concern%22&forms=10-K&limit=10"

GET /v1/coverage

Which datasets FinancialMD serves and which it does not (licensed, not built, or waiting on a decision), with the routes, MCP tools, reason and alternatives for each. Read it before looking for consensus estimates, transcripts or real-time prices.

Example: GET https://api.financial.md/v1/coverage?status=conceded

ParameterInDescription
statusqueryOnly datasets with this status
curl "https://api.financial.md/v1/coverage?status=conceded"

GET /v1/company/segments

As-reported segment facts: revenue and other lines by business segment, geography or product.

Example: GET https://api.financial.md/v1/company/segments?company=ticker:AAPL&kind=geography

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
period_typequeryAnnual (four quarters) or quarterly facts
kindquerySegment axis kind
tagqueryOnly this XBRL tag
limitqueryMaximum period ends
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/segments?company=ticker:AAPL&kind=geography"

GET /v1/company/line_items

Find one line of a company's own reporting by its label and period, without knowing the XBRL tag: detail lines below the standardized statements (interest expense, capital expenditures, deferred revenue), segment and geographic figures, company-defined metrics and guidance. Give q (the label) and period_end, or fiscal_year with fiscal_period. Each item carries its dataset, a match score and a value with a proof.

Example: GET https://api.financial.md/v1/company/line_items?company=ticker:AAPL&q=interest%20expense&period_end=2024-09-28&period_type=annual

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
q (required)queryThe line's label as a report prints it. Every word must be in the line's name
period_endqueryPeriod end; a line within six days of it matches (52/53-week years). Omit for each line's latest period
fiscal_yearqueryFiscal year, resolved to a period end through the company's own reports. Not with period_end
fiscal_periodqueryFiscal period of fiscal_year
period_typequeryLength of duration figures. Default: annual for FY, quarterly for a fiscal quarter, any otherwise
datasetqueryComma-separated: as_reported, segment, kpi, guidance. Default: all four
originalqueryas_reported only: the first filing's figure instead of the newest filing's
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum lines, best match first
curl "https://api.financial.md/v1/company/line_items?company=ticker:AAPL&q=interest%20expense&period_end=2024-09-28&period_type=annual"

GET /v1/screen/nl

Screen every covered company from a plain-language question. The question is parsed into GET /v1/screen parameters by an AI model, or by fixed rules when no model is configured; generated_by and label say which. Only the filters come from the parser: results are computed from filings by the same code as GET /v1/screen, and every value carries its proof. parsed and equivalent_request show the filters used, and unparsed lists what was not understood.

Example: GET https://api.financial.md/v1/screen/nl?q=technology%20companies%20with%20gross%20margin%20above%2040%25%20and%20revenue%20over%201%20billion&limit=20

ParameterInDescription
q (required)queryThe screen in plain English: a sector or an industry, and metrics with bounds. No links
limitqueryMaximum companies
curl "https://api.financial.md/v1/screen/nl?q=technology%20companies%20with%20gross%20margin%20above%2040%25%20and%20revenue%20over%201%20billion&limit=20"

GET /v1/ask

An AI-written answer to one question about one company, from its own filed values: statements, ratios, guidance, company metrics, segments and recent 8-K events. The model sees only a numbered list of those facts. The server checks that every number in the answer matches a fact it cites and withholds the answer otherwise (answer null, withheld_reason, related_facts). citations carries each cited value with its proof. It restates filed values; it does not compute, forecast or advise, and an answer with words of advice is withheld. Needs an API key or a signed-in connector token (an account without a plan has a daily allowance); keyless callers get 401.

Example: GET https://api.financial.md/v1/ask?company=ticker:AAPL&q=What%20was%20revenue%20and%20gross%20margin%20in%20the%20latest%20year%3F

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
q (required)queryOne question about the company, in plain English. No links
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/ask?company=ticker:AAPL&q=What%20was%20revenue%20and%20gross%20margin%20in%20the%20latest%20year%3F"

GET /v1/news/summary

An AI-written summary of filing-based news: market-wide for one UTC day (the most important filings of the day), or one company's events of the last 30 days. The model sees only numbered items of FinancialMD's own event feed (SEC filings, rule-made headlines and key numbers quoted from the filing). Each bullet cites its items, and the server drops a bullet with a number no cited item carries or with advice words; the summary is withheld when too many are dropped. Labelled ai_generated with the model. It does not forecast or advise.

Example: GET https://api.financial.md/v1/news/summary?date=2026-11-12

ParameterInDescription
companyqueryOne company: its events of the 30 days to date. Without it, the summary is market-wide: the most important filings of date
datequeryThe UTC day (YYYY-MM-DD), within the last 7 days. Default: the latest day with filings (market-wide) or today (one company). Older days: GET /v1/news/feed
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/news/summary?date=2026-11-12"

GET /v1/company/ownership/insider_holders

What each insider owned after their latest Form 4 or 5 transaction.

Example: GET https://api.financial.md/v1/company/ownership/insider_holders?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum holders
curl "https://api.financial.md/v1/company/ownership/insider_holders?company=ticker:AAPL"

GET /v1/company/ownership/funds

Funds holding the company in their latest Form N-PORT, with shares and value.

Example: GET https://api.financial.md/v1/company/ownership/funds?company=ticker:AAPL&limit=20

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
periodqueryReport period window ending on or before this date (default: the newest)
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum funds
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/ownership/funds?company=ticker:AAPL&limit=20"

GET /v1/funds

List or search Form N-PORT funds by name or series id. kind keeps one kind (etf, mutual_fund, closed_end, money_market), sort orders by net_assets or name. Each item has its kind, its net assets with the report date, and a series id to pass to /v1/fund/holdings and /v1/fund/profile.

Example: GET https://api.financial.md/v1/funds?kind=etf&sort=net_assets&limit=20

ParameterInDescription
qqueryFund or registrant name, or a series id
kindqueryOnly funds of this kind, from the registrant's latest Form N-CEN: etf, mutual_fund (open-end, not exchange-traded), closed_end (interval funds included) or money_market. A fund whose kind is not known matches no kind
sortqueryOrder by net assets of the latest report (funds without a report last) or by name
orderqueryDirection; default desc for net_assets and asc for name
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum funds
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/funds?kind=etf&sort=net_assets&limit=20"

GET /v1/fund/holdings

One fund's Form N-PORT holdings for a report period, largest first.

Example: GET https://api.financial.md/v1/fund/holdings?fund=S000002839&limit=20

ParameterInDescription
fund (required)querySEC series id
periodqueryReport period (month end); default the newest
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum holdings
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/fund/holdings?fund=S000002839&limit=20"

GET /v1/company/kpis

Company-reported metrics read from earnings releases and reports: adjusted (non-GAAP) measures and operating statistics such as product-line sales. Each value carries its exact citation and a confidence.

Example: GET https://api.financial.md/v1/company/kpis?company=ticker:AAPL&kind=operating&limit=20

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
metricqueryOnly this metric slug (data.metrics lists the company's)
kindqueryadjusted: non-GAAP measures under the company's own definition; operating: operating statistics
period_typequeryOnly this period type
fromqueryFirst period end, inclusive
toqueryLast period end, inclusive
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum values
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/kpis?company=ticker:AAPL&kind=operating&limit=20"

GET /v1/company/dividend_events

Cash dividends with declaration, record, ex and pay dates as the company's filings state them. When a filing states a record date but no ex-date, the ex-date is derived by the settlement rule and labelled ex_date_method: settlement_rule. With no record date there is no ex-date.

Example: GET https://api.financial.md/v1/company/dividend_events?company=ticker:AAPL&limit=8

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
fromqueryFirst date, inclusive
toqueryLast date, inclusive
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum dividends
curl "https://api.financial.md/v1/company/dividend_events?company=ticker:AAPL&limit=8"

GET /v1/company/ownership/insider_holdings

Holding lines of Forms 3, 4 and 5 as filed.

Example: GET https://api.financial.md/v1/company/ownership/insider_holdings?company=ticker:AAPL&limit=20

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
formqueryOnly lines of this form
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum lines
curl "https://api.financial.md/v1/company/ownership/insider_holdings?company=ticker:AAPL&limit=20"

GET /v1/fund/profile

A fund's type (ETF, index fund and others) from Form N-CEN and each share class's prospectus fees and expense ratio. Accepts a series id or a share-class ticker.

Example: GET https://api.financial.md/v1/fund/profile?fund=VOO

ParameterInDescription
fund (required)querySeries id or share-class ticker
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/fund/profile?fund=VOO"

GET /v1/company/identifiers

CIK, LEI and FIGI of a company with the evidence for each.

Example: GET https://api.financial.md/v1/company/identifiers?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/identifiers?company=ticker:AAPL"

GET /v1/identifiers/xref

Cross-reference one identifier to the others we lawfully hold: FMD id, CIK, tickers, LEI, FIGI, and for funds the series and class ids. Each identifier names its source and licence. A CUSIP or ISIN you already hold can be looked up; the answer names the SEC filing that reported it. We hold no licensed identifier master and never generate identifiers.

Example: GET https://api.financial.md/v1/identifiers/xref?id=BBG000B9XRY4

ParameterInDescription
id (required)queryThe identifier you hold
kindqueryWhat the identifier is; left out, it is detected from its shape
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/identifiers/xref?id=BBG000B9XRY4"

GET /v1/identifiers/master

Every covered company with its open identifiers (FMD id, CIK, tickers and exchanges, LEI, FIGI), paged. Contains no licensed identifiers.

Example: GET https://api.financial.md/v1/identifiers/master?limit=100

ParameterInDescription
limitqueryMaximum companies
cursorqueryOpaque cursor from meta.next_cursor
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/identifiers/master?limit=100"

GET /v1/fund/nav

What SEC filings say about a fund's value: series net assets at reported month ends and each class's monthly total return (Form N-PORT), a total return index we compute from those returns, and for closed-end funds the NAV and market price per share at fiscal year end (Form N-CEN). Not a daily NAV feed: filings carry none. A market price, where shown, is one venue's close and is labelled as not NAV.

Example: GET https://api.financial.md/v1/fund/nav?fund=VOO

ParameterInDescription
fund (required)querySeries id or share-class ticker
classqueryOnly this share class (class id or ticker)
fromqueryFirst month end
toqueryLast month end
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum months per class
curl "https://api.financial.md/v1/fund/nav?fund=VOO"

GET /v1/company/ratios/forward

Forward valuation ratios built on FinancialMD's own model-based estimates: forward_pe, forward_ps, forward_ev_ebit, forward_earnings_yield and forward_fcf_yield for the next one or two fiscal years. The numerator is the market capitalisation or enterprise value of the newest session held (one venue's close times filed shares). Every item says generated_by model, names the method, and carries the estimate, its interval and its track record. Not consensus and not an analyst figure. 404 not_found when no estimate or no price basis is held.

Example: GET https://api.financial.md/v1/company/ratios/forward?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
tickerqueryOne of the company's listings
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/ratios/forward?company=ticker:AAPL"

GET /v1/company/technicals

Technical indicators of a listing, computed by us from split-adjusted daily closes of one venue: simple and exponential moving averages, RSI, MACD, Bollinger bands, average true range and the close range. indicators= takes ids such as sma_50, ema_20, rsi_14, macd, bollinger_20, atr_14, range_252 (period 2 to 400). data.latest holds the newest session as value objects with proofs; data.items is the series, newest first. End of day, one venue, not the consolidated tape; descriptive statistics, not signals or advice.

Example: GET https://api.financial.md/v1/company/technicals?company=ticker:AAPL&indicators=sma_50,sma_200,rsi_14,macd

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
tickerqueryOne of the company's listings
indicatorsqueryComma-separated indicator ids, at most 12: sma_<n>, ema_<n>, rsi_<n>, macd (12, 26, 9), bollinger_<n>, atr_<n>, range_<n>; n is 2 to 400. Default: sma_20, sma_50, sma_200, ema_12, ema_26, rsi_14, macd, bollinger_20
fromqueryOldest session to return
toqueryCompute up to the last session on or before this day
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum sessions per page (newest first)
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/company/technicals?company=ticker:AAPL&indicators=sma_50,sma_200,rsi_14,macd"

GET /v1/company/stock_prices/returns

Price return, total return, annualised return and maximum drawdown over trailing windows, computed by us from single-venue daily closes and the splits and dividends in SEC filings. End of day, one venue, not the consolidated tape.

Example: GET https://api.financial.md/v1/company/stock_prices/returns?company=ticker:AAPL&windows=1m,1y,5y

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
tickerqueryOne of the company's listings
windowsqueryComma-separated windows: 1m, 3m, 6m, ytd, 1y, 3y, 5y, max. Default: all
toqueryEnd the windows at the last session on or before this day
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/stock_prices/returns?company=ticker:AAPL&windows=1m,1y,5y"

GET /v1/screen

Screen every covered company on its latest period. filter takes metric:min:max ranges with raw values (0.2 is 20 percent), sort takes metric:desc. Multi-year growth is screened with revenue_cagr_3y, revenue_cagr_5y, revenue_cagr_10y, net_income_cagr_3y and net_income_cagr_5y. Each result carries one value object with proof per metric. Amounts are in each company's reporting currency and are not converted: add country= (for example country=SE) to compare within one market.

Example: GET https://api.financial.md/v1/screen?filter=net_margin:0.2:,income_statement_total_revenues:10000000000:&sort=net_margin:desc&limit=20

ParameterInDescription
statusqueryListing status of the companies screened: active (default), delisted, inactive or all
metricsqueryComma-separated columns: concept ids (GET /v1/company/metrics) or ratio ids. Up to 12. Multi-year growth ids are revenue_cagr_3y, revenue_cagr_5y, revenue_cagr_10y, net_income_cagr_3y and net_income_cagr_5y: compound annual growth between the latest annual figure and the annual figure that many years earlier, matched by year; null when that year is missing or the start is not positive, and for net income when either end is not positive. Defaults to revenue, net income, the three margins, revenue growth and return on equity.
filterqueryComma-separated range filters metric:min:max; either bound may be empty. Values are raw: 0.1 is 10 percent, amounts are in the reporting currency. A company without a value for a filtered metric does not match.
sortquery<metric|name|ticker>[:asc|:desc]; companies without a value sort last. Default name:asc.
period_typequeryThe period type whose latest period is screened
qqueryName or ticker search (names as substring, tickers as prefix)
sectorqueryExact sector (case-insensitive)
industryqueryExact industry (case-insensitive)
templatequeryReporting template
countryqueryISO 3166-1 alpha-2
currencyqueryReporting currency (ISO 4217): only companies that report in it. Amounts in different currencies are never compared, so a sort or filter on a money column without this parameter screens the currency most companies of the screen report in (USD across the whole universe), and data.currency says so.
include_stalequeryKeep companies whose latest period ended more than data.stale_after_days before as_of. They are left out by default; each item carries stale.
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum companies per page
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/screen?filter=net_margin:0.2:,income_statement_total_revenues:10000000000:&sort=net_margin:desc&limit=20"

GET /v1/company/estimates

FinancialMD's own model-based baseline estimates for the next four quarters and two fiscal years (revenue, operating income, net income, diluted EPS, free cash flow), each with an 80 percent prediction interval, every component of the method, the facts it read and the method's measured errors. Also the company's own guidance as stated in its filings with the exact sentence, and descriptive signals. Computed only from SEC filings by the published method in docs/estimates.md. Not consensus, not analyst or Street estimates, not investment advice. When the company has no estimate in force and no guidance at as_of the answer is 404 not_found (error.details.reason no_estimates_or_guidance) and is not charged.

Example: GET https://api.financial.md/v1/company/estimates?company=ticker:AAPL&metric=revenue

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
metricqueryOnly this estimated line (default all five)
period_typequeryOnly quarters or only fiscal years
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/company/estimates?company=ticker:AAPL&metric=revenue"

GET /v1/company/estimates/consensus

Always 404 not_covered: consensus estimates are licensed data FinancialMD does not carry. error.details names the reason and what to use instead (our own model-based estimates are at /v1/company/estimates); do not retry.

Example: GET https://api.financial.md/v1/company/estimates/consensus?company=ticker:AAPL

curl "https://api.financial.md/v1/company/estimates/consensus?company=ticker:AAPL"

GET /v1/company/analyst_ratings

Always 404 not_covered: analyst ratings and price targets are licensed. error.details names the reason and what to use instead; do not retry.

Example: GET https://api.financial.md/v1/company/analyst_ratings?company=ticker:AAPL

curl "https://api.financial.md/v1/company/analyst_ratings?company=ticker:AAPL"

GET /v1/company/transcripts

Always 404 not_covered: call transcripts and audio are licensed. error.details names the reason and what to use instead; do not retry.

Example: GET https://api.financial.md/v1/company/transcripts?company=ticker:AAPL

curl "https://api.financial.md/v1/company/transcripts?company=ticker:AAPL"

GET /v1/company/stock_prices/intraday

Always 404 not_covered: real-time and intraday prices are licensed; daily IEX bars are at /v1/company/stock_prices. error.details names the reason and what to use instead; do not retry.

Example: GET https://api.financial.md/v1/company/stock_prices/intraday?company=ticker:AAPL

curl "https://api.financial.md/v1/company/stock_prices/intraday?company=ticker:AAPL"

An image that identifies a company. kind is wikimedia_commons (a logo file from Wikimedia Commons, taken only when the company matched a Wikidata item with confidence and the file is public domain or under a verified open licence; source carries the file page, author, licence and retrieval time, and attribution must be shown where the licence asks) or generated (a monogram tile drawn from the ticker, never an imitation of the real mark). format=svg or format=png with size returns the image itself. Logos are trademarks of their owners and are served for identification only; no endorsement is implied.

Example: GET https://api.financial.md/v1/company/logo?company=ticker:AAPL

ParameterInDescription
company (required)queryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
formatqueryjson: the description with links, licence and attribution; svg or png: the image itself
sizequeryLongest side of the PNG in pixels (format=png only)
curl "https://api.financial.md/v1/company/logo?company=ticker:AAPL"

GET /v1/pre_ipo

Companies that have filed to go public, from the SEC's public record: registrants whose first S-1 or F-1 came before any periodic report. Each item has a status set by a fixed rule (filed, effective, priced, listed, withdrawn, stale) with the sentence of the rule, the dates, the proposed ticker and exchange as the prospectus states them, and whether it is a blank check company. Filter by status, form, blank_check, name or proposed ticker (q) and the date of the newest filing. Confidential drafts and Form D raises are not covered. Use it to answer which companies have filed for an IPO.

Example: GET https://api.financial.md/v1/pre_ipo?status=filed,effective&blank_check=false&limit=10

ParameterInDescription
qqueryPart of the registrant's name, or its proposed ticker
statusqueryComma-separated: filed, effective, priced, listed, withdrawn, stale
formqueryForm of the newest registration statement
blank_checkquerytrue = only blank check companies, false = none of them
fromqueryNewest filing on or after this date
toqueryNewest filing on or before this date
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum registrants
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/pre_ipo?status=filed,effective&blank_check=false&limit=10"

GET /v1/pre_ipo/{cik}

One pre-IPO registrant by SEC CIK: its status and the rule that set it, every filing of the registration (S-1 or F-1, amendments, effectiveness, prospectus, withdrawal), the financial figures the registrant tagged in XBRL (revenue, net income, assets, cash and others, by period) and the offering terms read from the prospectus by fixed rules (shares offered, price range or price, proposed symbol and exchange, underwriters, use of proceeds), each with the sentence read, its position and a confidence. No model is used. A price range is a proposal, not a price.

Example: GET https://api.financial.md/v1/pre_ipo/2137779

ParameterInDescription
cik (required)pathThe registrant's SEC CIK, from GET /v1/pre_ipo
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/pre_ipo/2137779"

GET /v1/fx_rates

Daily reference exchange rates. The only source is the European Central Bank's euro foreign exchange reference rates, a public file set, loaded every working day. base is an ISO 4217 code (default USD); quotes is a comma-separated list of codes (default every currency published that day); date is optional and answers with the latest reference day on or before it, so a weekend or holiday answers with the working day before. rates[X] is units of X for one unit of base. The ECB quotes each currency against the euro, so a rate between two other currencies is computed through the euro from the same day (method cross_rate_through_eur). A currency with no rate on that day is left out of rates and named in not_served. source carries the name, link and attribution line; as_of_note states that these are reference rates set once a day, for information, and not tradable quotes. 400 invalid_request for a code the ECB has never published; 404 not_found (details.reason no_reference_rate, with first_day) when no rate for base exists on or before the date.

Example: GET https://api.financial.md/v1/fx_rates?base=USD&quotes=EUR,GBP,JPY&date=2026-11-12

ParameterInDescription
basequeryISO 4217 code of the base currency: the euro or a currency the ECB publishes a reference rate for
quotesqueryComma-separated ISO 4217 codes to quote; default every currency published on the reference day
datequeryAnswer with the latest reference day on or before this date; default today
curl "https://api.financial.md/v1/fx_rates?base=USD&quotes=EUR,GBP,JPY&date=2026-11-12"

GET /v1/research

Search DeepValues Research reports, newest first: Deep Value Intelligence company reports, company research notes, investor studies, insights, market memos, the value-investing principles and personal finance notes. Each item gives the id, title, collection, kind, language, date, tickers and companies, the stance a company report states, the report's page on research.deepvalues.ai, the licence and a summary: an extract of the report's own words chosen by rule, never written by a model. Filter by company (a ticker FinancialMD does not cover still matches reports filed under it), collection, kind, language, q (words in the title or summary), from and to. The reports are licensed CC BY 4.0 and readable at no cost on research.deepvalues.ai; GET /v1/research/{id} returns one report's whole text, structured. An empty result is a 200 with a request_data remedy.

Example: GET https://api.financial.md/v1/research?company=AAPL&limit=5

ParameterInDescription
companyqueryOptional: only reports filed under or tagged with this company. A ticker FinancialMD does not cover still matches the reports filed under it
collectionqueryOnly this collection
kindqueryOnly this kind of report (deep_value_intelligence: the multi-analyst company reports)
languagequeryOnly reports written in this language
qqueryWords in the title or the summary (all must appear)
fromqueryPublished on or after this date
toqueryPublished on or before this date
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
limitqueryMaximum reports
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/research?company=AAPL&limit=5"

GET /v1/research/{id}

One DeepValues Research report in full: the text as clean Markdown (images and front matter removed), its sections with character offsets into the text, tickers and companies, date and how it was read, the links the report cites, the summary, version (content SHA-256 and the repository commit it was read from), and the licence block with the attribution CC BY 4.0 asks for: credit "DeepValues Research (research.deepvalues.ai)" and link source_url and the licence. The same report is readable at no cost at source_url; this route sells the structured, citable delivery and claims no exclusivity. A withdrawn report (removed from the site) answers 404 with details.reason withdrawn, and an error is never charged.

Example: GET https://api.financial.md/v1/research/dvr_181b78646e4f0de6

ParameterInDescription
id (required)pathReport id from GET /v1/research
as_ofqueryPoint in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then.
curl "https://api.financial.md/v1/research/dvr_181b78646e4f0de6"

GET /proof/{id}

The proof behind any value: the filing, the XBRL tag and dimensions, the source URL and the raw as-reported facts it derives from.

Example: GET https://api.financial.md/proof/p_edt68ehn6cw3ed0

ParameterInDescription
id (required)pathProof id from any value object
curl "https://api.financial.md/proof/p_edt68ehn6cw3ed0"

POST /v1/verify

Check a number you got elsewhere against what the company filed. Returns verdict (matches, differs or unknown), the filed value with proof, the difference, the tolerance from the filer's precision, and a scale_hint when your number is off by a power of ten.

Example: POST https://api.financial.md/v1/verify with body {"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

GET /v1/changes

Standardized facts whose knowledge interval opened since a time: new filings and restatements. Poll it to keep a local copy current.

Example: GET https://api.financial.md/v1/changes?since=2026-11-01T00:00:00Z&company=ticker:AAPL&limit=50

ParameterInDescription
since (required)queryFacts whose knowledge interval opened at or after this instant
companyqueryCompany as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies
limitqueryMaximum changes
cursorqueryOpaque cursor from meta.next_cursor
curl "https://api.financial.md/v1/changes?since=2026-11-01T00:00:00Z&company=ticker:AAPL&limit=50"

GET /v1/request-data

How to tell us about data or analysis you needed and did not find: the body POST /v1/request-data takes, the kinds, the limits and how to follow a request.

Example: GET https://api.financial.md/v1/request-data

curl "https://api.financial.md/v1/request-data"

POST /v1/request-data

Tell us what you needed and did not find. Keyless, never charged. Similar requests merge into one demand item and count as votes; the answer has request_id, item_id, status and the vote counts. Do not include personal data.

Example: POST https://api.financial.md/v1/request-data with body {"kind":"dataset","want":"Quarterly order backlog by segment","why":"Modeling revenue visibility","company":"ticker:BA","endpoint_or_tool":"/v1/company/kpis"}

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" -d '{"kind":"dataset","want":"Quarterly order backlog by segment","why":"Modeling revenue visibility","company":"ticker:BA","endpoint_or_tool":"/v1/company/kpis"}'

GET /v1/request-data/{id}

Follow a request by the request_id POST /v1/request-data returned: new, triaged, planned, done (with served_by, the endpoint or tool) or wontfix (with a public note), and the vote counts.

Example: GET https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11

ParameterInDescription
id (required)pathThe request_id POST /v1/request-data returned, or a demand item id
curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

GET /v1/requested

Requested and shipped: the reviewed demand items with status, public note, served_by and vote counts, and counts per status. Aggregate only, no submitter details.

Example: GET https://api.financial.md/v1/requested

curl "https://api.financial.md/v1/requested"

GET /v1/feedback

How to tell us what worked and what did not (POST /v1/feedback) and how to report a number you believe is wrong (POST /v1/data-errors): the bodies, the limits and what happens next.

Example: GET https://api.financial.md/v1/feedback

curl "https://api.financial.md/v1/feedback"

POST /v1/feedback

Tell us what worked, what did not, or why an answer was wrong. Keyless, never charged. Send text, a rating (-1 or 1, or 1 to 5) or reasons. Notes are read and grouped every day; a wrong number is better sent to POST /v1/data-errors. Do not include personal data.

Example: POST https://api.financial.md/v1/feedback with body {"text":"Quarterly ratios for MSFT stop at 2023","rating":-1,"reasons":["missing_data"],"route_or_tool":"/v1/company/ratios"}

curl -X POST "https://api.financial.md/v1/feedback" -H "content-type: application/json" -d '{"text":"Quarterly ratios for MSFT stop at 2023","rating":-1,"reasons":["missing_data"],"route_or_tool":"/v1/company/ratios"}'

POST /v1/data-errors

Report a number you believe is wrong. Keyless, never charged. The answer compares your expected value with what we serve now; open tickets are checked against the SEC's companyfacts daily and marked confirmed or rejected. Follow it with GET /v1/data-errors/{id}.

Example: POST https://api.financial.md/v1/data-errors with body {"company":"AAPL","statement":"income_statement","field":"income_statement_total_revenues","period":"FY2024","expected_value":391035000000,"source_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}

curl -X POST "https://api.financial.md/v1/data-errors" -H "content-type: application/json" -d '{"company":"AAPL","statement":"income_statement","field":"income_statement_total_revenues","period":"FY2024","expected_value":391035000000,"source_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}'

GET /v1/data-errors/{id}

Follow a reported number by the ticket_id POST /v1/data-errors returned: new, already_served, confirmed, rejected, needs_review or unverifiable, with what we serve now.

Example: GET https://api.financial.md/v1/data-errors/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11

ParameterInDescription
id (required)pathThe ticket_id POST /v1/data-errors returned
curl "https://api.financial.md/v1/data-errors/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

GET /v1/me

For a keyed caller: principal, plan and remaining limits. Needs an API key; keys come with the Terminal + Agent plans.

Example: GET https://api.financial.md/v1/me

curl "https://api.financial.md/v1/me"
API referens · FinancialMD