Check domain blacklists

Check one domain against Spamhaus DBL and SURBL using direct DNS first. If that fails, try WhoAPI, then retry direct DNS once if needed. Successful list results are preserved across attempts. When both lists were checked successfully and either reports a listing, reuse that result for three days (72 hours) from its original check time. Repeated requests do not extend the cache lifetime. After expiry, the next request checks again. Clean results and incomplete checks are not cached. The domain does not need to be imported into Peeker. The check does not update saved domain health.

blacklisted is true when either supported domain list reports a listing. IP-based lists and mail-server IPs are excluded.

Checks fail open: if providers remain unavailable after all attempts, return 200 with the same response shape as a clean result. Any confirmed listing is preserved; otherwise blacklisted and unavailable list flags default to false. Failed checks returned as clean are never cached, so calling again runs fresh checks. Responses use Cache-Control: no-store for clients; the listed-result cache is managed by Peeker on the server. checked_at records when the check attempts finished and keeps that original timestamp when a cached listing is returned.

Requires a live key with full or limited permissions. Sandbox keys return 403 forbidden and do not call the provider. Allow up to 45 seconds for the full retry sequence.

POST

domains

blacklist

Check domain blacklists

curl --request POST \
  --url https://api.peeker.ai/partner/v1/domains/blacklist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com"
}
'

{
  "data": {
    "domain": "example.com",
    "blacklisted": false,
    "spamhaus_dbl": {
      "listed": false
    },
    "surbl": {
      "listed": false
    },
    "checked_at": "2026-09-08T12:00:00.000Z"
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

Authorizations

Authorization

string

header

default:Bearer pk_test_<your-test-key>

required

Partner API key (pk_live_… or pk_test_…).

Body

application/json

domain

string

required

A domain name, without a URL scheme, path, or IP address. Whitespace is trimmed and letters are lowercased.

Maximum string length: 253

Example:

"example.com"

Response

Domain blacklist findings. Unavailable lists default to false.

data

object

required

Show child attributes

Last modified on October 5, 2026

Check domain blacklists

curl --request POST \
  --url https://api.peeker.ai/partner/v1/domains/blacklist \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "example.com"
}
'

{
  "data": {
    "domain": "example.com",
    "blacklisted": false,
    "spamhaus_dbl": {
      "listed": false
    },
    "surbl": {
      "listed": false
    },
    "checked_at": "2026-09-08T12:00:00.000Z"
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

{
  "error": {
    "code": "emailbison_super_admin_key",
    "message": "Use an EmailBison workspace/user API key; super-admin keys are not accepted.",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "field": "credentials.api_key",
    "details": {}
  }
}

Account

Provider workspaces

Bundles

Domains

Domain pool

Orders

Domain swaps

Check domain blacklists

Authorizations

Body

Response