Skip to main content
GET
/
api
/
detections
/
hits
cURL
curl -X GET "https://app.cotool.ai/api/detections/hits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "hits": [
    {
      "id": "<string>",
      "detectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "detectionName": "<string>",
      "detectionDescription": "<string>",
      "detectionCategory": "<string>",
      "detectionSiemType": "<string>",
      "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "runTitle": "<string>",
      "runCreatedAt": "<string>",
      "entityType": "<string>",
      "confidence": 123,
      "evidence": [
        "<string>"
      ],
      "summary": "<string>",
      "headline": "<string>",
      "cta": "<string>",
      "statistics": [
        "<string>"
      ],
      "severity": "low",
      "entity": "<string>"
    }
  ],
  "totalCount": 123,
  "summary": {
    "uniqueDetections": 1,
    "avgConfidence": 1,
    "hitsLast24h": 1,
    "hitsOverTime": [
      {
        "date": "<string>",
        "count": 1
      }
    ],
    "severityCounts": {
      "critical": 1,
      "high": 1,
      "medium": 1,
      "low": 1
    }
  }
}

Authorizations

Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Query Parameters

limit
integer
default:100

Maximum number of hits to return per page (1-200, default: 100)

Required range: 1 <= x <= 200
offset
integer
default:0

Number of hits to skip for pagination (default: 0)

Required range: x >= 0

Response

200 - application/json

Successful response

hits
object[]
required
totalCount
number
required

Total number of hits across all detections (for pagination)

summary
object

Aggregate summary for all matching hits (returned on initial page load)