API Reference

List Notable CVE Events

Return CVE notable events recorded within a rolling time window: new NVD entries, high EPSS score jumps, CISA KEV additions, and similar signals.

GET

/v1/cve/notable-events

Cost: 1 credit per successful call

Query parameters

event_typestringoptional

Filter results to a single event type. Maximum 40 characters, pattern ^[A-Za-z0-9_]+$. Known values: NEW_NVD, HIGH_EPSS_DELTA, LOW_EPSS_DELTA, NEW_CISA. Omit to return all event types.

daysintegeroptionaldefault: 7

Look-back window in days. Accepted range: 1–30.

limitintegeroptionaldefault: 100

Maximum number of events to return. Accepted range: 1–500.

Request

curl "https://api.precursorintelligence.com/functions/v1/cve/notable-events?event_type=NEW_CISA&days=3&limit=50" \
  -H "Authorization: Bearer $PRECURSOR_API_KEY"

Response

200 OK

{
  "data": {
    "count": 2,
    "event_type": "NEW_CISA",
    "days": 3,
    "limit": 50,
    "items": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "cve": "CVE-2024-3094",
        "event_type": "NEW_CISA",
        "event_time": "2026-05-27T09:00:00Z",
        "details": "CVE added to CISA Known Exploited Vulnerabilities"
      },
      {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "cve": "CVE-2024-21887",
        "event_type": "NEW_CISA",
        "event_time": "2026-05-26T14:30:00Z",
        "details": "CVE added to CISA Known Exploited Vulnerabilities"
      }
    ],
    "generated_at": "2026-05-29T08:15:00Z"
  },
  "meta": {
    "request_id": "8b16efb8-9a6c-4ace-b817-11cbee626d08",
    "generated_at": "2026-05-18T10:24:31.118Z",
    "credits": { "charged": 1, "remaining": 9998 }
  }
}

Response fields

data.countintegeroptional

Number of events returned (equals items.length).

data.event_typestring | nulloptional

The event-type filter applied to this request, or null when no filter was supplied.

data.daysintegeroptional

The look-back window used for this request, in days.

data.limitintegeroptional

The maximum number of events requested.

data.itemsarrayoptional

Notable events within the window, most recent first. Each object contains the fields below.

data.items[].idstringoptional

Unique identifier for the event record.

data.items[].cvestringoptional

CVE identifier the event relates to.

data.items[].event_typestringoptional

Machine-readable event type, such as NEW_NVD, HIGH_EPSS_DELTA, LOW_EPSS_DELTA, or NEW_CISA.

data.items[].event_timestringoptional

ISO 8601 UTC timestamp when the event occurred.

data.items[].detailsstringoptional

Short human-readable description of the event.

data.generated_atstringoptional

ISO 8601 timestamp indicating when this response was generated.

Errors

Status	`error`	When
400	`invalid_event_type`, `invalid_days`, `invalid_limit`	A parameter failed validation.
401	`invalid_authorization`	Missing or malformed `Authorization` header.
401	`unauthorized`	Invalid/revoked key, or IP not allowlisted.
402	`insufficient_credits`	Organisation credit balance is below 1.
404	`not_found`	The route or entity does not exist.
405	`method_not_allowed`	Only `GET` and `OPTIONS` are accepted.
500	`internal`	Unexpected server error (credit auto-refunded).

See Errors for the full error reference.