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

Un instantané chiffré du projet : répartition des alertes par sévérité, alertes KEV/PoC, et volumétrie (stack, URLs surveillées, abonnements EOL). Les compteurs portent sur les alertes du projet, communes à l’équipe.

Requête

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

Paramètres de chemin

Paramètre	Type	Description
`org_id`	`UUID`	Identifiant de l’organisation
`project_id`	`UUID`	Identifiant du projet

Réponse `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
}

Champs

Champ	Type	Description
`total_alerts`	`integer`	Total d’alertes CVE sur le projet
`unread_alerts`	`integer`	Alertes que personne dans l’équipe n’a encore lues
`alerts_by_severity`	`object`	Nombre d’alertes par sévérité
`kev_alerts`	`integer`	Alertes sur des CVE du catalogue KEV
`poc_alerts`	`integer`	Alertes sur des CVE avec PoC public
`stack_items`	`integer`	Items de la stack surveillée
`monitored_urls`	`integer`	URLs surveillées
`eol_subscriptions`	`integer`	Abonnements End-of-Life

Erreurs

Code	Détail	Cause
`404`	`Projet introuvable`	Projet inexistant, d’une autre organisation, ou hors de la restriction de projets de la clé
`403`	`Cette clé API n'a pas le droit d'accéder à cette ressource.`	Le scope `stats` manque à la clé

Exemple

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

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