Developer Reference

Reverse IP Lookup (Deprecated)

Explore Reverse IP Lookup (Deprecated) API documentation, request parameters, response fields, code examples, and error handling for DomScan integrations.

Reverse IP Lookup (Deprecated)

Deprecated: this endpoint searches valid IPv4 or IPv6 addresses only against a best-effort seven-day index populated by prior /v1/dns/all lookups. Each IP keeps at most 10,000 recent entries. The API evaluates limit entries before returning one row per apex by default, and it is not an internet-wide dataset.

GET /v1/reverse/ip

Query Parameters

ParameterTypeDescription
ip required string Valid IPv4 or IPv6 address to check in the deprecated DomScan passive index (e.g., "93.184.216.34" or "2001:db8::1")
dedupe_apex optional boolean When true (default), return one row per apex domain. Set false to preserve observed hostnames.
limit optional number Maximum recent index entries to evaluate before optional apex deduplication. Default: 100, max: 1000.

Use Cases

  • Check cached DomScan observations for an IP
  • Review prior API lookup context only
  • Confirm whether DomScan has seen related domains before
  • Use as a limited legacy signal, not a full dataset

Example Request

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34&limit=50"

Example Response

{
  "query": {
    "ip": "93.184.216.34",
    "asn": null,
    "expand": "none",
    "dedupe_apex": true
  },
  "deprecated": true,
  "deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
  "results": [],
  "summary": {
    "total_found": 0,
    "returned": 0
  },
  "coverage_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "passive_index": true,
    "result_count": 0,
    "returned_count": 0,
    "apex_deduped_count": 0,
    "warning_count": 2,
    "warnings": ["passive_cache_only", "no_cached_matches"],
    "last_seen_span_days": null
  },
  "page": {
    "limit": 50,
    "next_cursor": null
  },
  "meta": {
    "source": "passive_dns",
    "note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
  }
}

Response Fields

Field Type
query object
query.ip string | null
query.asn integer | null
query.expand string
query.dedupe_apex boolean
deprecated boolean
deprecation_notice string
ip_context object
ip_context.ip string
ip_context.asn integer
ip_context.asn_name string
results[] object[]
results[] object
results[].domain string
results[].apex string
results[].ips[] string[]
results[].last_seen string | null
results[].reason object
results[].reason.type string
results[].reason.matched string
results[].reason.source string
summary object
summary.total_found integer
summary.returned integer
coverage_summary object
coverage_summary.source string
coverage_summary.cache_status string
coverage_summary.passive_index boolean
coverage_summary.result_count integer
coverage_summary.returned_count integer
coverage_summary.apex_deduped_count integer
coverage_summary.warning_count integer
coverage_summary.warnings[] string[]
coverage_summary.last_seen_span_days integer | null
page object
page.limit integer
page.next_cursor string | null
meta object
meta.generated_at string
meta.source string
meta.query_time_ms integer
meta.note string
cache object
cache.hit boolean | null
cache.age_s integer | null
cache.ttl_s integer | null
cache.key string | null