AnkraDocs
Console

API reference · Account and billing

Abuse incidents

1 operation of the Ankra Cloud API: Abuse incidents raised from connection metadata of a server's outbound traffic (never a payload): port scans, SSH or RDP brute force, outbound floods, spam, contact with botnet command-and-control servers and mining pools. An account reads its own; Ankra's staff tell the account, quarantine the server's network (the server keeps running with its disks), release it or dismiss the incident.

The account's abuse incidents, newest first#

GET/v1/abuse-incidents
Operation
list_abuse_incidents
Credentials
API token, Portal session
Requires
Permission read

What Ankra saw coming from the account's servers, from connection metadata only (never a payload). An incident in status quarantined is why a server has no network: the server keeps running with its disks until Ankra releases it. active=true keeps the open, notified and quarantined ones.

Parameters

Parameters
NameInTypeDescription
activequerybooleanOnly incidents that still stand.
cursorquerystringThe next_cursor of the previous page.
limitqueryintegerPage size; the server applies its default and maximum.

Responses

200A page of incidents (limit at most 100, default 20).application/json · AbuseIncidentList

200 response fields
FieldTypeDescription
itemsrequiredarray of AbuseIncident
idrequiredstring
server_idrequiredstring
server_hostnamerequiredstring
zonerequiredstring
rulerequiredstringOne of port_scan, brute_force, outbound_flood, spam, command_and_control, mining_pool
severityrequiredstringOne of low, medium, high
confidencerequiredstringOne of low, medium, high
statusrequiredstringopen, notified and quarantined incidents still stand; released and dismissed are final.One of open, notified, quarantined, released, dismissed
summaryrequiredstringWhat was seen in the last sample that fired the rule.
evidencerequiredAbuseEvidenceThe numbers the incident was last raised on, over one sample window. Never a payload.
window_secondsrequiredinteger (int64)
new_outbound_connectionsrequiredinteger (int64)
outbound_connectionsrequiredinteger (int64)
distinct_destination_addressesrequiredinteger (int64)
distinct_destination_portsrequiredinteger (int64)
unanswered_syn_connectionsrequiredinteger (int64)
peak_transmitted_packets_per_secondrequiredinteger (int64)
peak_transmitted_bytes_per_secondrequiredinteger (int64)
baseline_packets_per_secondrequirednumberThe server's own normal outbound rate.
baseline_bytes_per_secondrequirednumber
ssh_connectionsrequiredinteger (int64)
ssh_destination_addressesrequiredinteger (int64)
rdp_connectionsrequiredinteger (int64)
rdp_destination_addressesrequiredinteger (int64)
smtp_connectionsrequiredinteger (int64)
smtp_destination_addressesrequiredinteger (int64)
matched_addressrequiredstringThe destination a threat intelligence list names; empty for other rules.
matched_listrequiredstringThe list that names it: feodo_tracker or mining_pools; empty for other rules.
is_truncatedrequiredbooleanThe server tracked more connections than one sample reads; the counts cover those read.
observationsrequiredinteger (int64)How many samples fired the rule while the incident stood.
first_seen_atrequiredstring (date-time)
last_seen_atrequiredstring (date-time)
notified_atrequiredstring (date-time) | null
quarantined_atrequiredstring (date-time) | null
released_atrequiredstring (date-time) | null
dismissed_atrequiredstring (date-time) | null
next_cursorrequiredstring | nullPass as ?cursor= for the next page; null on the last page.
  • 400The request is invalid; detail says why.
  • 401Not signed in, or the credential is invalid or expired.
  • 403The role lacks the permission, the token is read-only (a read-only token also gets reason: read_only_token_cannot_read_credentials on every credential read), the CSRF header is missing, a support session may not do this, or the route needs a verified email address and the caller's is not (reason: email_unverified).
  • 429Rate limited. On a customer operation the credential (the API token, or the signed-in user for a session) is over its requests per minute and the X-RateLimit-* headers say when the window ends; on a sign-in route the client network is over its attempts or the email is locked out.
  • defaultAny other error, usually 500.

Example

bash
curl 'https://cloud.ankra.app/v1/abuse-incidents' \
  -H "Authorization: Bearer $ANKRA_CLOUD_TOKEN"