Fiscal.ai - API Reference

Full API reference for every Fiscal.ai endpoint — company profiles, as-reported and standardized financials, ratios, KPIs, stock prices, and filings.

Company Key:

A company key combines an exchange and ticker symbol. For US/CA exchanges, the format is exchange_ticker (e.g., NASDAQ_MSFT for Microsoft). For other exchanges, it uses MIC code: MIC_TICKER (e.g., XWAR_PKN for a Warsaw Stock Exchange listing). Use either ticker and exchange OR companyKey.

Companies List

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/companies-list

Get a list of all companies

Lists all companies available in the dataset together with basic descriptors and the types of data available for each company.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

pageNumbernumber

Page number (1-indexed)

pageSizenumber

Number of items per page, max 1000

Request
$ curl "https://api.fiscal.ai/v2/companies-list"
Response

Company Profile

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/profile

Get profile for a single company

Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v2/company/profile"
Response

Financials As Reported - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/income-statement/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/income-statement/as-reported"
Response

Financials As Reported - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/balance-sheet/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/balance-sheet/as-reported"
Response

Financials As Reported - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/cash-flow-statement/as-reported

Get as-reported financials for a company

Returns raw financial statement line items exactly as disclosed by the company, including source document links for traceability.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/cash-flow-statement/as-reported"
Response

Financials Standardized - Income Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/income-statement/standardized

Get standardized financials for a company

Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/income-statement/standardized"
Response

Financials Standardized - Balance Sheet

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/balance-sheet/standardized

Get standardized financials for a company

Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/balance-sheet/standardized"
Response

Financials Standardized - Cash Flow Statement

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/financials/cash-flow-statement/standardized

Get standardized financials for a company

Returns standardized financial statements where line items are mapped to a common schema, enabling apples-to-apples comparison across companies.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/financials/cash-flow-statement/standardized"
Response

Standardized Metrics List

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/standardized-metrics-list/{templateType}/{statementType}

Get the list of all standardized metrics.

Returns the list of all standardized metrics.

Parameters

templateTypestringpathrequired

Reporting template category

statementTypestringpathrequired

Financial statement category

apiKeystring

API Key (alternatively send via X-Api-Key header)

Request
$ curl "https://api.fiscal.ai/v1/standardized-metrics-list/{templateType}/{statementType}"
Response

All Standardized Metrics

Loading API specification...

Company Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/ratios

Get all ratios time series for a company

Calculates and returns all supported financial ratios for the specified company across the selected period types. Where applicable, calculated intermediate metrics are omitted from the response unless diagnostics are requested.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

include_diagnosticsboolean

Include diagnostics in the response

ratioIdstring

Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.

Request
$ curl "https://api.fiscal.ai/v1/company/ratios"
Response

Daily Ratios

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/ratios/daily/{ratioId}

Get daily ratio time-series for a company

Returns a daily time-series for the specified ratio. The ratio is recomputed for each trading day using the closing share price for that day and the most recently reported fundamental inputs (e.g. EPS, shares outstanding) available as of that date.

Parameters

ratioIdstringpathrequired

ID of the ratio (e.g. ratio_price_to_earnings)

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/ratios/daily/{ratioId}"
Response

Ratios List

Full List of Ratios:

For a full list of ratios, see our Ratios Reference.

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/ratios-list

Get the list of all ratios.

Returns the list of all ratios.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

Request
$ curl "https://api.fiscal.ai/v1/ratios-list"
Response

Shares Outstanding

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/shares-outstanding

Get the latest shares outstanding for a company

Returns the total number of shares outstanding and detailed share-class breakdown as of the latest available filing for the company.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/company/shares-outstanding"
Response

Adjusted Metrics

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/adjusted-metrics

Get the latest adjusted metrics for a company

Returns the adjusted metrics for a company.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be exactly 3 letters. Defaults to company's reporting currency.

Request
$ curl "https://api.fiscal.ai/v1/company/adjusted-metrics"
Response

Segments and KPIs

Loading API specification...

Earnings Calendar

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/calendar/earnings

Get earnings calendar events

Returns earnings calendar data powered by Benzinga, including scheduled earnings dates, EPS and revenue estimates, reported actuals, and surprise metrics. Filter by tickers, date range, or importance level.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickersstring

Comma-separated company keys (EXCHANGE_TICKER format, e.g. NASDAQ_AAPL,NYSE_MSFT) or plain ticker symbols (AAPL,MSFT). Max 50.

datestring

Single date to query (YYYY-MM-DD). Shorthand for dateFrom and dateTo when both are the same.

dateFromstring

Start date for date range filter (YYYY-MM-DD)

dateTostring

End date for date range filter (YYYY-MM-DD)

importanceinteger

Minimum importance level to filter by (0-5). Returns events with importance greater than or equal to this value.

pageinteger

Page offset for pagination (0-100000)

pageSizeinteger

Number of results per page

dateSortstring

Sort by date. Use date:asc or date:desc

updatedinteger

Only return records updated after this Unix timestamp (UTC)

isinstring

ISIN to look up. Resolves to ticker via our database, then queries Benzinga. Requires CUSIP/ISIN license.

cusipstring

CUSIP to look up. Resolves to ticker via our database, then queries Benzinga. Requires CUSIP/ISIN license.

Request
$ curl "https://api.fiscal.ai/v1/calendar/earnings"
Response

Stock Splits

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/stock-splits

Get the stock splits for a company

Provides all historical stock split and stock dividend events for the requested company, including split ratio and relevant dates.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/company/stock-splits"
Response

Stock Prices

Loading API specification...

Company Filings (v2)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/filings

Get filings for a company

Retrieves a list of filings for the specified company from the last 20 years. Currently supports: - Annual Report - Interim Report - Earnings Press Release - Current Report - Initial Registration Statement The fiscal year, quarter, and report date are only available if there was financial data extracted from the filing.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v2/company/filings"
Response

Filing Image (by page)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/filing/{filingId}/page/{pageNumber}/image

Get an image of a filing page

Fetches a high-resolution JPEG image of the specified page from the original SEC filing document. Suitable for embedding in client applications for source traceability.

Parameters

filingIdstringpathrequired

Filing ID

pageNumbernumberpathrequired

Page number

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/filing/{filingId}/page/{pageNumber}/image"
Response

Filing PDF

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/filing/{filingId}/pdf

Get the full PDF of a filing

Downloads the complete PDF version of the SEC filing referenced by its accession number.

Parameters

filingIdstringpathrequired

Filing ID

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/filing/{filingId}/pdf"
Response
API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v2/company/logo

Get a published company logo asset

Returns a published company logo as image bytes. Supports icon, logo (light), and logo-dark variants.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

variantstring

Logo variant: icon (square app icon / avatar), logo (logomark for light surfaces), logo-dark (logomark for dark surfaces)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v2/company/logo"
Response

Company News

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/news

Get company news

Returns company news.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

startDatestring

Optional start date of the inclusive UTC date range. If supplied, endDate must also be supplied. If startDate and endDate are both omitted, the endpoint returns the latest 14 UTC dates.

endDatestring

Optional end date of the inclusive UTC date range. If supplied, startDate must also be supplied. If startDate and endDate are both omitted, the endpoint returns the latest 14 UTC dates.

eventTypestring

Optional filter to a single normalized event type.

importanceinteger

Optional filter to a single exact importance score.

Request
$ curl "https://api.fiscal.ai/v1/company/news"
Response

News eventType Values

Event type describes the category of the news item.

ValueMeaning
earningsQuarterly or annual results, revenue, profit, or EPS
guidanceForward guidance, outlook, or forecasts
dividendDividend declarations, dividend changes, or special dividends
stock_splitForward splits, reverse splits, ratio changes, or ex-split dates
buybackShare repurchase programs or authorizations
maMergers, acquisitions, or divestitures involving ownership/control of a company or business
partnershipStrategic partnerships, joint ventures, commercial agreements, purchase agreements, customer orders, or supply agreements
product_launchNew product or service announcements
expansionGeographic expansion, new markets, or new facilities
regulatoryRegulatory approvals, compliance actions, or fines
legalLawsuits, settlements, or legal proceedings
executiveC-suite changes, board appointments, or departures
restructuringLayoffs, reorganizations, or cost-cutting
financingDebt issuance, equity offerings, or credit facilities
technologyR&D milestones, patent grants, or technology developments
esgESG initiatives, sustainability reports, or social programs
analystConcrete analyst rating, initiation, downgrade, upgrade, or price-target action
market_commentarySubstantive market or industry analysis where the company is a primary subject
otherCompany-specific news that does not fit another category

News importance Values

Importance reflects the impact of the news item. Some event types are naturally more likely to be important, but each item is scored based on its specific substance.

ScoreLabelMeaning
1Major EventMaterial development with high significance
2Measurable ImpactNews with a quantified impact or surprise
3Notable UpdateMeaningful new information
4Minor MentionCompany mention in broader or lower-impact coverage
5Routine EventRoutine or lower-substance news

Companies List (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/companies-list

[DEPRECATED] Get a list of all companies (use /v2/companies-list instead)

Lists all companies available in the dataset together with basic descriptors and the types of data available for each company. This endpoint is deprecated, please use /v2/companies-list instead.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

Request
$ curl "https://api.fiscal.ai/v1/companies-list"
Response

Company Profile (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/profile

[DEPRECATED] Get profile for a single company (use /v2/company/profile instead)

Retrieves a detailed company profile including sector, industry, descriptions and lists the datasets currently available under the Fiscal.ai system. This endpoint is deprecated, please use /v2/company/profile instead.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/company/profile"
Response

Company Filings (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/filings

[DEPRECATED] Get filings for a company (use /v2/company/filings instead)

Retrieves a list of filings for the specified company from the last 20 years. This endpoint is deprecated, please use /v2/company/filings instead.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/company/filings"
Response

Stock Prices (v1)

API Key Required
Set your API key to test the endpoints directly from the documentation.
GET/v1/company/stock-prices

Get the stock prices for a company

Returns the daily closing share price series for the specified company. Prices are split-adjusted and expressed in the company reporting currency where applicable. Currently, only primary listings are supported.

Parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Request
$ curl "https://api.fiscal.ai/v1/company/stock-prices"
Response