Threat intelligence

The Threat Intelligence API manages your IOC (Indicator of Compromise) library — IPs, domains, file hashes, CVEs, and more — and exposes the curated global feeds that Sentinel uses for automated detection.

IOC types

NameTypeRequiredDescription
ipstringNoSingle IPv4 or IPv6 address.
cidrstringNoIP range in CIDR notation.
domainstringNoMalicious or suspicious domain.
urlstringNoFull URL to a malicious resource.
hash_md5stringNoMD5 file hash.
hash_sha1stringNoSHA-1 file hash.
hash_sha256stringNoSHA-256 file hash.
emailstringNoMalicious sender email address.
cvestringNoCVE identifier (e.g. CVE-2024-12345).
asnstringNoAutonomous system number.

List IOCs

bash
GET /v1/sentinel/threat-intel/iocs
NameTypeRequiredDescription
filter[type]stringNoFilter by IOC type.
filter[severity]stringNocritical | high | medium | low | informational
filter[active]booleanNotrue (default) returns active IOCs only.
searchstringNoFull-text search across IOC values.

Add an IOC

bash
POST /v1/sentinel/threat-intel/iocs
NameTypeRequiredDescription
valuestringYesThe indicator value.
typestringYesIOC type.
severitystringNoDefaults to medium.
descriptionstringNoContext about this indicator.
sourcestringNomanual | hld_pulse | misp | virustotal | custom
confidenceintegerNoConfidence score 0–100. Defaults to 80.
tagsarrayNoString tags for filtering and correlation.
expires_atstringNoISO 8601. IOC is auto-deactivated after this date.
bash
curl -X POST https://api.hldgroup.org/v1/sentinel/threat-intel/iocs \
  -H "Authorization: Bearer hld_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "type": "hash_sha256",
    "severity": "critical",
    "description": "LockBit ransomware staging binary — confirmed from incident inc_01hxyz.",
    "source": "manual",
    "confidence": 99,
    "tags": ["ransomware", "lockbit", "staging"]
  }'

HLD Pulse feeds

Sentinel automatically ingests threat intelligence from HLD Pulse — our curated threat briefing and IOC platform. Pulse feeds are updated continuously and feed directly into Sentinel's detection engine.

bash
GET /v1/sentinel/threat-intel/feeds
json
{
  "data": [
    {
      "id": "feed_hld_pulse",
      "name": "HLD Pulse",
      "type": "managed",
      "ioc_count": 42819,
      "last_updated_at": "2025-06-01T14:00:00Z",
      "enabled": true
    },
    {
      "id": "feed_cisa_kev",
      "name": "CISA Known Exploited Vulnerabilities",
      "type": "public",
      "ioc_count": 1187,
      "last_updated_at": "2025-06-01T12:00:00Z",
      "enabled": true
    }
  ]
}
Note:IOCs added via the API are automatically matched against active incidents and enrolled devices. High-confidence matches generate alerts within 60 seconds of IOC creation.