# Get a single News Event by ID

> Get a single News Event by ID is a paid API for AI agents from agents.predictleads.com, paid per call via MPP, $0.04/call, status unknown (last checked 2026-10-30).

Retrieves a specific company news event record by its UUID, including category, summary, headcount, location, and related company/article data.

## Facts

- Endpoint: GET https://agents.predictleads.com/api/v3/news_events/{id}?utm_source=zero.xyz
- Price: $0.04/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-get-a-single-news-event-by-id-995eee64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aa96EHtgcNyBg3RESyHUY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-predictleads-com-get-a-single-news-event-by-id-995eee64
```

Example prompt: Pull up the PredictLeads news event with ID e120b1e6-0270-4cdd-913d-d037ef9da422 — I need the full details including the event category, summary, headcount, location, and the company it's associated with.

## When to prefer this

Use this endpoint when you already have a specific PredictLeads news event UUID and need the full structured record for that event. It is ideal for resolving references from search or discovery endpoints, enriching downstream systems with event details, or verifying specific attributes like headcount, location, or confidence score. Prefer this over discovery/search endpoints when you have a direct ID reference and need low-latency point lookup rather than a list.

## Known failure modes

- Invalid or malformed UUID returns a 400 or 404 error
- News event ID does not exist in the PredictLeads database returns a 404 not found
- Expired or missing payment/auth credentials return a 402 or 401 error
- Truncated or incomplete response if the news event record has sparse attributes
- Network timeout for slow upstream PredictLeads API responses

## How this service works

Returns specific News Event.

## Output

Returns a JSON object containing a data array with one news event record, including attributes such as event category (e.g. 'increases_headcount_by'), summary, headline, headcount, location, location_data, confidence score, found_at, effective_date, planning flag, financing type, product data, and relationships to the associated company and most relevant source news article. Also includes an 'included' array with sideloaded company and article metadata, plus meta fields for record_state and schema_version.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "format": "uuid",
   "description": "NewsEvent's ID.\n"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "NewsEventsDataset",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "data": [
   {
    "id": "e120b1e6-0270-4cdd-913d-d037ef9da422",
    "type": "news_event",
    "attributes": {
     "award": null,
     "event": null,
     "amount": null,
     "assets": null,
     "contact": null,
     "product": null,
     "summary": "On Oct 20th '26, Amazon.com Inc. aims to add 300000 seasonal workers to its fulfillment and transportation network across the United States during the holiday rush, up from 250,000 in each of the prior three years.",
     "category": "increases_headcount_by",
     "division": null,
     "found_at": "2026-10-20T00:00:00Z",
     "headline": "Amazon.com Inc. aims to increase its seasonal workforce by 300000 in the United States on Oct 20th '26",
     "location": "United States, Northern America, Americas",
     "planning": true,
     "headcount": 300000,
     "job_title": null,
     "confidence": 1,
     "assets_tags": [],
     "recognition": null,
     "product_data": {
      "name": null,
      "full_text": null,
      "fuzzy_match": null,
      "release_type": null,
      "release_version": null
     },
     "product_tags": [],
     "first_seen_at": "2026-10-20T14:44:30Z",
     "location_data": [
      {
       "city": null,
       "state": null,
       "region": "Northern America",
       "country": "United States",
       "zip_code": null,
       "continent": "Americas",
       "fuzzy_match": false
      }
     ],
     "vulnerability": null,
     "effective_date": "2026-10-20",
     "financing_type": null,
     "job_title_tags": [],
     "article_sentence": "Amazon aims to add 300,000 seasonal workers - and expands health benefits in the new year.",
     "amount_normalized": null,
     "company1_importance": "high",
     "company2_importance": null,
     "financing_type_tags": [],
     "financing_type_normalized": null
    },
    "relationships": {
     "company1": {
      "data": {
       "id": "c9b92ffd-a2ed-5787-8b06-f4bf8d291e57",
       "type": "company"
      }
     },
     "most_relevant_source": {
      "data": {
       "id": "d7dbb269-ada6-4300-8578-d7b23332049f",
       "type": "news_article"
      }
     }
    }
   }
  ],
  "meta": {
   "record_state": "active",
   "schema_version": "3.3"
  },
  "included": [
   {
    "id": "c9b92ffd-a2ed-5787-8b06-f4bf8d291e57",
    "type": "company",
    "attributes": {
     "domain": "amazon.com",
     "ticker": "NASDAQ:AMZN",
     
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-predictleads-com-get-a-single-news-event-by-id-995eee64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.predictleads.com](https://www.zero.xyz/host/agents.predictleads.com/llms.txt)