> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/docs/ip-lookup

# IP Geolocation

DomScan API: IP intelligence including geolocation, ASN and network details, and security signals. Supports both direct IP lookups and domain resolution.

IP intelligence including geolocation, ASN and network details, and security signals. Supports both direct IP lookups and domain resolution. Includes Tor exit node detection, cloud provider identification, and datacenter detection for fraud prevention and security analysis.

GET /v1/ip Credits: 1

#### Query parameters

| Parameter | Type | required |
| --- | --- | --- |
| ip | string | optional |
| domain | string | optional |

#### Response fields

| Field | Type |
| --- | --- |
| `ip` | string |
| `domain` | string \| null |
| `geolocation` | object |
| `geolocation.country` | string \| null |
| `geolocation.country_name` | string \| null |
| `geolocation.region` | string \| null |
| `geolocation.region_name` | string \| null |
| `geolocation.city` | string \| null |
| `geolocation.postal` | string \| null |
| `geolocation.latitude` | number \| null |
| `geolocation.longitude` | number \| null |
| `geolocation.timezone` | string \| null |
| `geolocation.precision` | string |
| `network` | object |
| `network.asn` | integer \| null |
| `network.asn_name` | string \| null |
| `network.asn_org` | string \| null |
| `network.isp` | string \| null |
| `network.connection_type` | string \| null |
| `security` | object |
| `security.is_proxy` | boolean |
| `security.is_vpn` | boolean |
| `security.is_tor` | boolean |
| `security.is_tor_exit` | boolean |
| `security.is_datacenter` | boolean |
| `security.is_cloud` | boolean |
| `security.cloud_provider` | string \| null |
| `security.threat_score` | integer |
| `security.is_vpn_suspected` | boolean |
| `security.vpn_suspected_provider` | string \| null |
| `security.type_classification` | object |
| `security.type_classification.type` | string |
| `security.type_classification.confidence` | string |
| `security.fcrdns` | object |
| `security.fcrdns.ptr` | string \| null |
| `security.fcrdns.fcrdns_valid` | boolean \| null |
| `intelligence_summary` | object |
| `intelligence_summary.query_type` | string |
| `intelligence_summary.domain_resolved` | boolean |
| `intelligence_summary.cache_status` | string |
| `intelligence_summary.data_source` | string |
| `intelligence_summary.confidence` | string |
| `intelligence_summary.confidence_score` | integer |
| `intelligence_summary.asn_present` | boolean |
| `intelligence_summary.organization_present` | boolean |
| `intelligence_summary.country_present` | boolean |
| `intelligence_summary.security_signal_count` | integer |
| `intelligence_summary.risk_flags[]` | string[] |
| `intelligence_summary.hosting_category` | string |
| `meta` | object |
| `meta.query_time_ms` | integer |
| `meta.cached` | boolean |
| `meta.source` | string |
| `meta.data_updated_at` | string \| null |
| `meta.attribution` | object |
| `meta.attribution.name` | string |
| `meta.attribution.url` | string |
| `meta.attribution.license` | string |
| `meta.attribution.license_url` | string |
| `meta.attribution.modified` | boolean |
| `meta.warning_code` | string \| null |

#### Example request

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com"
```

```javascript
const response = await fetch("https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### Example response

```json
{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": null,
    "region_name": "California",
    "city": "Mountain View",
    "postal": null,
    "latitude": 37.422,
    "longitude": -122.085,
    "timezone": null,
    "precision": "city"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": null,
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "intelligence_summary": {
    "query_type": "ip",
    "domain_resolved": false,
    "cache_status": "miss",
    "data_source": "db-ip-lite+enrichment",
    "confidence": "high",
    "confidence_score": 100,
    "asn_present": true,
    "organization_present": true,
    "country_present": true,
    "security_signal_count": 2,
    "risk_flags": [
      "cloud",
      "datacenter"
    ],
    "hosting_category": "cloud"
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "db-ip-lite+enrichment",
    "data_updated_at": "2026-08-01T01:42:04.000Z",
    "attribution": {
      "name": "DB-IP Lite",
      "url": "https://db-ip.com",
      "license": "CC BY 4.0",
      "license_url": "https://creativecommons.org/licenses/by/4.0/",
      "modified": true
    }
  }
}
```

#### HTTP status codes

- `200` OK
- `400` Bad Request
- `401` Unauthorized
- `402` Payment Required
- `429` Too Many Requests
- `503` Service Unavailable
- `504` Gateway Timeout
