API Documentation

IP & CIDR lookup API

Query Spike's blocklist with a single authenticated GET request. Check any IPv4/IPv6 address or CIDR range and get back whether it's listed, why, and by which entry.

1 · AUTHENTICATION

Every request must include your API key in the Authorization header. Keys are created from your Sendcorex dashboard.

  1. 1 Open API Keys in your dashboard and click New API Key.
  2. 2 Under Permissions, enable the spike:lookup scope.
  3. 3 Copy the key right away. It's only shown once.

2 · CHECK AN IP OR CIDR

GEThttps://sec.sendcorex.com/check

Headers

Authorization Your API key. REQUIRED

Query parameters

ipstring An IPv4 or IPv6 address (e.g. 102.223.92.101) or a CIDR range (e.g. 45.142.0.0/16). REQUIRED

3 · EXAMPLE REQUEST

curl "https://sec.sendcorex.com/check?ip=102.223.92.101" \
  -H "Authorization: YOUR_API_KEY"

4 · RESPONSE

{
  "ip": "102.223.92.101",
  "query_type": "ip",
  "blocked": true,
  "listed_as": "ip",
  "matched_by": "102.223.92.101/32",
  "exact": true,
  "category": "probe",
  "message": "This IP address is listed.",
  "is_ipv6": false
}

Response fields

ipstringThe value you queried, echoed back.
query_type"ip" | "network"Whether the query was a single address or a CIDR range.
blockedbooleantrue when the address or network is on the Spike blocklist.
listed_as"ip" | "network"How the match is listed: as an individual address or as part of a listed network. Only present when blocked is true.
matched_bystringThe exact entry that matched (e.g. 102.223.92.101/32 or 66.132.172.0/24). Only present when blocked is true.
exactbooleantrue when the queried value is itself listed; false when it is only covered by a listed network.
category"probe" | "scanner"probe: observed sending abusive or malicious traffic. scanner: a known research internet scanner, not a confirmed attack. Only present when blocked is true.
scanner_namestringName of the scanner (e.g. Censys). Only present when category is scanner.
messagestringA human-readable summary of the result.
is_ipv6booleantrue for IPv6 queries.

5 · INTERPRETING RESULTS

category: probe

Observed sending abusive or malicious traffic. You should reject connections from it, or treat traffic from it as untrusted.

category: scanner

A known research scanner that probes ports across the internet. Listed for probing our infrastructure, which isn't a confirmed attack. Blocking is your call.

exact: false

The address isn't listed on its own, but it belongs to a listed network. Check matched_by for the network that caused it.

blocked: false

Nothing in the blocklist matches the queried address or network right now.

Ready to integrate?

Create a key with the spike:lookup scope and make your first request in minutes.

Contact us