Sign in

v3

latestOpenAPI 3.1.02026-07-26490368.4 KB
News

Get company news

Returns company news.

get/v1/company/news

Query parameters

apiKeystring

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

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

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

Example:XNAS

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

Company key (alternative to ticker/micCode/exchange)

cusipstring

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

Example:594918104

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

Example:US5949181045

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

figistring

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

Example:BBG000BPH459

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

cikstring

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

Example:789019

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

fsclstring

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

Example:FSCLC6CGT4DXS597

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

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

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.

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"
  }
]