TIRESIS/API Docs

REST API Reference

JSON API for SMB CVE scores, forecast data, and threat intelligence. Base URL: https://api.tiresis.com

API Key richiesto — header: X-API-Key: your_key
Endpoints
GET/api/cveGET/api/cve/:idGET/api/cve/stats/summaryGET/api/pressure/historyGET/api/forecast/logGET/api/forecast/accuracy
Request API Key

Authentication

Ogni richiesta richiede un API key nell'header HTTP. Scrivici a api@tiresis.com per richiedere accesso — API in beta.

curl -H "X-API-Key: sk_tiresis_xxxx" https://api.tiresis.com/api/cve?label=critical
GEThttps://api.tiresis.com/api/cve— List CVEs

CVEs scored with SMB Attack Probability Score. Filterable and paginated.

Parameters
ParameterTypeDefaultDescription
daysint30CVEs published in last N days
limitint50Max results (max 500)
labelstring—critical | high | medium | low
kevboolfalseOnly CISA KEV entries
productstring—Filter by affected product
Example Request
GET https://api.tiresis.com/api/cve?label=critical&days=30&kev=true
Response
{
  "total": 3,
  "data": [{
    "cve_id": "CVE-2025-15556",
    "smb_attack_probability_score": 69.7,
    "smb_attack_probability_label": "high",
    "epss_score": 0.039,
    "in_kev": true,
    "affected_products": ["fortigate","fortios"],
    "published": "2025-11-12T00:00:00Z"
  }]
}
GEThttps://api.tiresis.com/api/cve/:cve_id— CVE Detail

Full detail for one CVE: score breakdown, SMB exposure, patch lag estimate.

Parameters
ParameterTypeDefaultDescription
cve_idstring—e.g. CVE-2025-15556
Example Request
GET https://api.tiresis.com/api/cve/CVE-2025-15556
Response
{
  "cve_id": "CVE-2025-15556",
  "smb_attack_probability_score": 69.7,
  "score_breakdown": {
    "epss_component": 22.1,
    "kev_component": 25,
    "smb_exposure": 14.2,
    "exploit_maturity": 5,
    "attack_vector": 3.4
  },
  "in_kev": true,
  "smb_prevalence_pct": 30,
  "patch_lag_days": 62
}
GEThttps://api.tiresis.com/api/cve/stats/summary— CVE Stats

Aggregate counts by label. Useful for dashboards and monitoring.

Example Request
GET https://api.tiresis.com/api/cve/stats/summary
Response
{
  "total_scored": 200,
  "critical": 3, "high": 12,
  "medium": 45, "low": 140,
  "in_kev": 8, "ransomware_linked": 5
}
GEThttps://api.tiresis.com/api/pressure/history— Pressure Index History

Monthly SMB Threat Pressure Index (0–100) with historical series.

Parameters
ParameterTypeDefaultDescription
monthsint12Months of history (max 36)
Example Request
GET https://api.tiresis.com/api/pressure/history?months=12
Response
{
  "current": {
    "month": "2026-03",
    "pressure_score": 42,
    "pressure_level": "ELEVATED"
  },
  "monthly": [
    { "month": "Mar '26", "pressure_score": 42,
      "pressure_level": "ELEVATED",
      "cves_scored": 220, "kev_count": 6 }
  ]
}
GEThttps://api.tiresis.com/api/forecast/log— Forecast Log

Top-N CVE predictions logged at each pipeline run, with validation status.

Parameters
ParameterTypeDefaultDescription
limitint10Number of predictions
validatedboolfalseOnly validated predictions
Example Request
GET https://api.tiresis.com/api/forecast/log?limit=10
Response
{
  "data": [{
    "cve_id": "CVE-2025-15556",
    "predicted_score": 69.7,
    "logged_at": "2026-02-01T02:00:00Z",
    "validated": true,
    "was_exploited": true,
    "days_to_exploit": 11
  }]
}
GEThttps://api.tiresis.com/api/forecast/accuracy— Forecast Accuracy

Hit rate statistics. Available after 60+ days of validated predictions.

Example Request
GET https://api.tiresis.com/api/forecast/accuracy
Response
{
  "total_predictions": 120,
  "validated": 98,
  "exploited": 71,
  "hit_rate_pct": 72.4,
  "avg_days_to_exploit": 14.2
}

Rate Limits

Requests / ora
1,000
Max risultati / call
500
Dati CVE aggiornati
Ogni 24h
Pressure Index
Mensile