DNS Blocklist

The DNS blocklist endpoints let you check whether your domain or IP address has been listed on any DNS blocklists. This is useful for detecting email deliverability issues and reputation problems on any monitor with the DNS blocklist check enabled.

You'll need a monitor ID for these endpoints.

Example request:

$ OHDEAR_TOKEN="your API token"
$ curl https://ohdear.app/api/monitors/1/dns-blocklist-history-items \
    -H "Authorization: Bearer $OHDEAR_TOKEN" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json'

All endpoints below follow the same authentication pattern.

Get a specific blocklist check #

GET /api/monitors/{monitorId}/dns-blocklist-history-items/{dnsBlocklistHistoryItemId}

Returns a single DNS blocklist check result by its ID.

Here's what the response looks like:

{
  "id": 1,
  "checked_domain": "example.com",
  "resolved_ips": [
    "93.184.216.34"
  ],
  "blocklist_results": [
    {
      "provider": "zen.spamhaus.org",
      "listed": false,
      "query_target": null,
      "return_code": null,
      "reason": null,
      "timed_out": false
    },
    {
      "provider": "bl.spamcop.net",
      "listed": false,
      "query_target": null,
      "return_code": null,
      "reason": null,
      "timed_out": false
    }
  ],
  "issues": null,
  "created_at": "2024-06-15 14:30:00"
}

• checked_domain: the domain that was checked against blocklists
• resolved_ips: the IP addresses the domain resolved to at the time of checking
• blocklist_results: results from each blocklist provider. Each entry contains:
  • provider: the blocklist identifier (e.g., zen.spamhaus.org)
  • listed: whether the domain/IP was found on this blocklist
  • query_target: the queried domain or IP
  • return_code: the DNS return code if listed
  • reason: a human-readable reason if listed
  • timed_out: whether the check timed out
• issues: any issues detected during the check, or null
• created_at: when this check was performed (UTC)

List blocklist check history #

GET /api/monitors/{monitorId}/dns-blocklist-history-items

Returns a paginated list of DNS blocklist check results. Each item follows the same shape as the single response above.

Query parameters:

• filter[created_at] (string, optional) -- only return results created at or after this timestamp in YmdHis format, in UTC (e.g., 20240615000000)