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
| Parameter | Type | Description |
|---|---|---|
| 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 |