Skip to main content
Get full details of a specific detection by ID.

Endpoint

GET /api/v1/detections/:id

Path Parameters

ParameterTypeDescription
idstringDetection ID

Example Request

curl http://localhost:8000/api/v1/detections/finding_abc123

Response

{
  "id": "finding_abc123",
  "rule_name": "flash_loan_attack",
  "detector_name": "flash_loan_attack",
  "severity": "CRITICAL",
  "priority": "CRITICAL",
  "chain": "ethereum",
  "type": "rule",
  "tx_hash": "0x9e5c7835e4fcd9a289820c4e42c623c4ab80bd50896b4e5b27e3c18f79be6341",
  "block_number": 18450123,
  "timestamp": "2025-11-11T21:30:00Z",
  "description": "Flash loan attack detected: 1000 ETH borrowed",
  "tags": ["defi", "flash-loan"],
  "metadata": {
    "tx_from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "tx_to": "0x123f4567890abcdef1234567890abcdef123456",
    "tx_value": "1000000000000000000"
  }
}

Response Fields

FieldTypeDescription
idstringUnique detection ID
rule_namestringName of the rule that triggered
detector_namestringDetector name (same as rule_name)
severitystringSeverity level (NOTICE, WARNING, CRITICAL)
prioritystringPriority level (same as severity)
chainstringBlockchain network
typestringDetection type (usually “rule”)
tx_hashstringTransaction hash
block_numbernumberBlock number
timestampstringDetection timestamp (ISO 8601)
descriptionstringAlert message/description
tagsarrayRule tags
metadataobjectAdditional transaction metadata