API Reference

List Top Affected Systems

Return the most-referenced affected systems across intelligence reporting, ranked by mention count (highest first).

GET

/v1/remediation/affected-systems

Cost: 1 credit per successful call

Query parameters

limitintegeroptionaldefault 10

Maximum number of systems to return. Accepted range: 1–50.

Request

curl "https://api.edgeprotect.io/functions/v1/remediation/affected-systems?limit=15" \
  -H "Authorization: Bearer $EDGEPROTECT_API_KEY"

Response

{
  "data": {
    "count": 15,
    "items": [
      { "system_name": "Microsoft Exchange Server", "blog_count": 412 },
      { "system_name": "Cisco IOS XE", "blog_count": 318 },
      { "system_name": "Fortinet FortiOS", "blog_count": 274 }
    ],
    "generated_at": "2026-05-18T10:24:31.118Z"
  },
  "meta": {
    "request_id": "8b16efb8-9a6c-4ace-b817-11cbee626d08",
    "generated_at": "2026-05-18T10:24:31.118Z",
    "credits": { "charged": 1, "remaining": 9998 }
  }
}

Response fields

data.countintegeroptional

Number of systems returned (equals items.length).

data.itemsarrayoptional

The affected systems, ranked by blog_count descending. Each object contains the fields below.

data.items[].system_namestringoptional

Name of the affected system as referenced in intelligence reporting.

data.items[].blog_countintegeroptional

Number of intelligence reports / blog mentions referencing this system.

data.generated_atstringoptional

ISO 8601 UTC timestamp indicating when this response was produced.

Errors

Status	`error`	When
400	`invalid_limit`	`limit` is not an integer, or is outside the 1–50 range.
401	`invalid_authorization`	The `Authorization` header is missing or malformed.
401	`unauthorized`	The key is invalid, revoked, or the request IP is not on the allowlist.
402	`insufficient_credits`	The organisation's credit balance is below 1.
404	`not_found`	The route or resource does not exist.
405	`method_not_allowed`	Only `GET` and `OPTIONS` are accepted.
500	`internal`	An unexpected server error occurred.

See Errors for the full error reference.