---
title: "Get News Events"
method: GET
path: "/companies/{company_id_or_domain}/news_events"
tags: ["News Events Dataset"]
---
# Get News Events
`GET /companies/{company_id_or_domain}/news_events`
## Request
- Base URL: `https://predictleads.com/api/v3`
- URL: `https://predictleads.com/api/v3/companies/{company_id_or_domain}/news_events`
- Auth: one of:
- API key in header `X-API-KEY` and API key in header `X-API-TOKEN`
- HTTP basic
- OAuth 2
- Client credentials
- Token URL: `https://oauth.predictleads.com/token`
Returns a list of company's News Events.
## Path parameters
- `company_id_or_domain` string, required
## Query parameters
- `location` string
- `found_at_from` string, date
- `found_at_until` string, date
- `categories` union[]
- union
- 'acquires': Company acquired another company.
**Group**: `acquisition`
**Optional `attributes`:** `amount`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'merges_with': Company merges with another company.
**Group**: `acquisition`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'sells_assets_to': Company sells assets (like properties or warehouses) to other company.
**Group**: `acquisition`
**Optional `attributes`:** `amount`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'loses_client': Company loses a client.
**Group**: `contract`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'signs_new_client': Company signs new client.
**Group**: `contract`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'declares_bankruptcy': Organization declares bankruptcy.
**Group**: `corporate_challenges`
**Present `attributes`:** `bankruptcy`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'files_suit_against': Company files suit against other company.
**Group**: `corporate_challenges`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'has_issues_with': Company has vulnerability problems.
**Group**: `corporate_challenges`
**Present `attributes`:** `vulnerability`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'closes_offices_in': Company closes existing offices.
**Group**: `cost_cutting`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'decreases_headcount_by': Company lays off employees.
**Group**: `cost_cutting`
**Present `attributes`:** `headcount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'attends_event': Company attends an event.
**Group**: `expansion`
**Present `attributes`:** `event`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'expands_facilities': Company opens new or expands existing facilities like warehouses, data centers, manufacturing plants etc.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'expands_offices_in': Company expands existing offices.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'expands_offices_to': Company opens new offices in another town, state, country or continent.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'increases_headcount_by': Company offers new job vacancies.
**Group**: `expansion`
**Present `attributes`:** `headcount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'opens_new_location': Company opens new service location like hotels, restaurants, bars, hospitals etc.
**Group**: `expansion`
**Present `attributes`:** `location`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'goes_public': Company issues shares to the public for the first time.
**Group**: `investment`
**Present `attributes`:** `financing_type`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_earnings': Earnings were reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_earnings_decreased_by': Company earnings decreased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_earnings_increased_by': Company earnings increased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_loss': Loss was reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_revenue': Revenue was reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_revenue_decreased_by': Company revenue decreased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_revenue_increased_by': Company revenue increased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_valuation': Valuation was reported for a company.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_valuation_decreased_by': Company valuation decreased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'has_valuation_increased_by': Company valuation increased by a reported percent.
**Group**: `investment`
**Present `attributes`:** `percent`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'invests_into': Company invests into other company.
**Group**: `investment`
**Optional `attributes`:** `amount`, `financing_type`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'invests_into_assets': Company buys assets (like properties or warehouses) from other company.
**Group**: `investment`
**Present `attributes`:** `assets`
**Optional `attributes`:** `amount`, `location`, `effective_date`
**Present `relationships`:** `company1`
- 'receives_financing': Company receives financing like venture funding, loan, grant etc.
**Group**: `investment`
**Present `attributes`:** `amount`
**Optional `attributes`:** `financing_type`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'hires': Company hired new executive or senior personnel.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'leaves': Executive or senior personnel left the company.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company2`
- 'promotes': Company promoted existing executive or senior personnel.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'retires_from': Executive or senior personnel retire from the company.
**Group**: `leadership`
**Present `attributes`:** `contact`
**Optional `attributes`:** `job_title`, `effective_date`, `location`
**Present `relationships`:** `company2`
- 'adopts_technology': Company adopts a technology.
**Group**: `new_offering`
**Present `attributes`:** `product`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'integrates_with': Company integrates with other company.
**Group**: `new_offering`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'is_developing': Company is developing a new offering.
**Group**: `new_offering`
**Present `attributes`:** `product`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- 'launches': Company launches new offering.
**Group**: `new_offering`
**Present `attributes`:** `product`
**Optional `attributes`:** `event`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'licenses_technology': Company licenses a technology to another company.
**Group**: `new_offering`
**Optional `attributes`:** `product`, `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'ends_partnership_with': Company ends partnership with other company.
**Group**: `partnership`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'partners_with': Company partners with another company.
**Group**: `partnership`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'receives_award': Company or person at the company receives an award.
**Group**: `recognition`
**Present `attributes`:** `award`
**Optional `attributes`:** `contact`, `event`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'recognized_as': Company or person at the company receives recognition.
**Group**: `recognition`
**Present `attributes`:** `recognition`
**Optional `attributes`:** `contact`, `event`, `effective_date`, `location`
**Present `relationships`:** `company1`
- 'identified_as_competitor_of': New or existing competitor was identified.
**Group**: `relational`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'spins_off_company': Company spins off another company.
**Group**: `relational`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`, `company2`
- 'spins_off_division': Company spins off a division.
**Group**: `relational`
**Present `attributes`:** `division`
**Optional `attributes`:** `effective_date`, `location`
**Present `relationships`:** `company1`
- `page` integer
- `limit` integer
## Response `200`
Request was successfully processed.
- NewsEventsDataset: Since 2016, PredictLeads has detected over 9 million relevant news signals, which are available for 2.4 million companies globally.
The News Events are sourced from some 20 million blogs, news and PR sites and distilled into relevant categories by machine learning algorithms.
The News Events dataset includes fields such as Formatted Signal, Signal Category, Most Relevant Source URL, Article Sentence, Article Body, Article Author, Found At, Effective Date and other News Event information.
- `data` NewsEvent[], required (unresolved $ref)
- `included` union[], required: Contains objects referenced in property `relationships`.
- union
- CompanyLite (unresolved $ref)
- NewsArticleLite (unresolved $ref)
- `meta` object: Meta information about `NewsEventsDataset` object.
- `schema_version` string, required: Represents schema version of objects.
- `record_state` 'active', required: Represents record state of objects.
- `count` integer: Total number of results.
**NOTE**: Only included in API responses when the request parameter `page` is provided, for performance reasons.
## Other responses
- `400`: Invalid request body or parameters.
- `401`: Authentication credentials are invalid or API subscription is not activated.
- `402`: Exceeded the monthly request limit.
- `403`: Request rate over limit.
- `404`: Record not found.
- `422`: Provided data failed to validate.
- `429`: Too many requests.
- `500`: Internal server error.
- `503`: Service temporarily unavailable.
## Changes
- **2026-10-22** `5fd893afec7d`: 1 breaking
- added `subschema #19, subschema #20, subschema #21, subschema #23, subschema #24, subschema #26, subschema #27, subschema #35, subschema #39` to the `data/items/attributes/category` response property `oneOf` list for the response status `200`
- **2026-10-15** `e5a0f8356dcd`: 1 info
- added the required property `data/items/attributes/headline` to the response with the `200` status
- **2026-10-03** `ff3b5bffadc5`: 3 info
- added the required property `data/items/attributes/company1_importance` to the response with the `200` status
- added the required property `data/items/attributes/company2_importance` to the response with the `200` status
- added the required property `data/items/attributes/first_seen_at` to the response with the `200` status
- **2026-10-01** `113413aee4a2`: 1 info
- api operation id `company_news_events` removed and replaced with `get_api_v3_companies_news_events`
- …earlier changes not shown
[Operation history](https://skmtc.dev/predictleads/apis/predictleads-api-reference/changes/companies/:company_id_or_domain/news_events/get.md)
---
[API](https://skmtc.dev/predictleads/apis/predictleads-api-reference.md) - [All operations](https://skmtc.dev/predictleads/apis/predictleads-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/predictleads/apis/predictleads-api-reference/revisions/ccb9fec6a710?raw)