FIfiscal
News

Get company news

Changed on

Returns company news.

get/v1/company/news

Request

  • Base URL
    https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.fiscal.ai/v1/company/news
  • Auth
    API key in query parameter apiKey

Query parameters

apiKeystring

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

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT
micCodestring

Company MIC, use with ticker

Example:XNAS
exchangestring

Company exchange code, use with ticker

Example:NASDAQ
companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT
cusipstring

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

Example:594918104
isinstring

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

Example:US5949181045
figistring

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

Example:BBG000BPH459
cikstring

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

Example:789019
fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597
startDatestring

Start date of the inclusive UTC date range. Must be supplied together with endDate. If both are omitted, returns the latest 14 UTC dates.

Example:2026-04-18
endDatestring

End date of the inclusive UTC date range. Must be supplied together with startDate. Range cannot exceed 31 days. If both are omitted, returns the latest 14 UTC dates.

Example:2026-05-01
eventType'earnings' | 'guidance' | 'dividend' | 'stock_split' | 'buyback' | 'ma' | 'partnership' | 'product_launch' | 'expansion' | 'regulatory' | 'legal' | 'executive' | 'restructuring' | 'financing' | 'technology' | 'esg' | 'analyst' | 'market_commentary' | 'other'

Optional filter to a single normalized event type. For multiple event types, use /v1/top-news (comma-separated eventType).

Example:earnings
importanceinteger

Optional filter to a single exact importance score (1-5). For multiple levels or a range, use /v1/top-news (minImportance/maxImportance).

Example:2
directArticle'true' | 'false'

Optional. We added directArticle because some customers prefer to tell these links apart. We recommend not filtering on it, so you get the full breadth of the news: a story is just as relevant whether its link opens the article itself or a list, feed or quote page. true returns only articles whose sourceUrl opens the story's own article; false returns only articles whose sourceUrl opens a list, feed or quote page.

Example:true

Response

Company news articles sorted newest first by UTC file date, then collection timestamp.

datestring required

UTC date of the stored news file.

titlestring required
descriptionstring required
summarystring required
eventTypestring required

News event category.

importanceinteger required

Relative importance score. Scores run from 1 to 5: 1 = Major Event, 2 = Measurable Impact, 3 = Notable Update, 4 = Minor Mention, 5 = Routine Event.

sourceUrlstring required
collectedAtstring required

UTC timestamp when the article was collected.

directArticleboolean required

true when sourceUrl opens the story's own article; false when it opens a list, feed or quote page.

Example response

[
  {
    "date": "2026-04-29",
    "title": "Company announces strategic acquisition",
    "description": "A short description of the material news event.",
    "summary": "A concise summary of the news and why it matters for the company.",
    "eventType": "ma",
    "importance": 2,
    "sourceUrl": "https://example.com/news/company-announces-acquisition",
    "collectedAt": "2026-04-29T01:47:11Z",
    "directArticle": true
  }
]

Changes

  • e96148e6bd76Revision changes
    • info

      added the new optional query request parameter directArticle

    • info

      added the required property / to the response with the status