GET /v1/organizations/{org_id}/projects/{id}/stats

A numeric snapshot of the project: alert breakdown by severity, KEV/PoC alerts, and volume (stack, monitored URLs, EOL subscriptions). Alert counts reflect your alerts on the project.

Request

GET /api/v1/organizations/{org_id}/projects/{project_id}/stats
Authorization: Bearer twa_your_key_here

Path Parameters

Parameter	Type	Description
org_id	UUID	Organization identifier
project_id	UUID	Project identifier

Response 200 OK

{
  "total_alerts": 128,
  "unread_alerts": 12,
  "alerts_by_severity": { "CRITICAL": 8, "HIGH": 34, "MEDIUM": 70, "LOW": 16 },
  "kev_alerts": 5,
  "poc_alerts": 21,
  "stack_items": 14,
  "monitored_urls": 3,
  "eol_subscriptions": 7
}

Fields

Field	Type	Description
total_alerts	integer	Total CVE alerts on the project
unread_alerts	integer	Unread alerts
alerts_by_severity	object	Alert count per severity
kev_alerts	integer	Alerts on KEV-listed CVEs
poc_alerts	integer	Alerts on CVEs with a public PoC
stack_items	integer	Monitored stack items
monitored_urls	integer	Monitored URLs
eol_subscriptions	integer	End-of-Life subscriptions

Errors

Code	Detail	Cause
404	Projet introuvable	Project not found or not in this organization
403	Accès refusé à ce projet	You are not a member of the project

Example

ORG_ID="018e5678-abcd-7000-8000-000000000001"
PROJECT_ID="018e1234-abcd-7000-8000-000000000010"

curl -s \
  -H "Authorization: Bearer twa_your_key_here" \
  "https://app.techwatchalert.com/api/v1/organizations/${ORG_ID}/projects/${PROJECT_ID}/stats" \
  | jq '{critical: .alerts_by_severity.CRITICAL, kev: .kev_alerts, unread: .unread_alerts}'