Skip to main content
POST
/
api
/
ext
/
generic
/
email
/
ip-blacklist-check
Check IP blacklist status
curl --request POST \
  --url https://app.spotzee.com/api/ext/generic/email/ip-blacklist-check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data ipv4=192.168.1.1 \
  --data ipv6=2001:0db8:85a3:0000:0000:8a2e:0370:7334 \
  --data type=popular
{
  "status": "success",
  "data": {
    "ip_address": "192.0.2.1",
    "results": {
      "listed": 5,
      "unlisted": 3,
      "errors": 0
    },
    "check_results": [
      {
        "rbl": "Spamhaus ZEN",
        "status": "Listed"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use format: Bearer YOUR_API_KEY

Body

application/x-www-form-urlencoded
​
ipv4
string

IPv4 address to check (provide either IPv4 or IPv6, not both)

Example:

"192.168.1.1"

​
ipv6
string

IPv6 address to check (provide either IPv4 or IPv6, not both)

Example:

"2001:0db8:85a3:0000:0000:8a2e:0370:7334"

​
type
enum<string>

Type of blacklist check: full (comprehensive) or popular (common blacklists only)

Available options:
full,
popular
Example:

"popular"

Response

Successfully checked IP blacklist status

​
status
enum<string>
required

Indicates successful operation

Available options:
success
​
data
object
required