Veille

IP Reputation

GET
/v1/intelligence/ip

Assess the reputation of any IP address. Detects VPNs, proxies, Tor exit nodes, datacenter hosting, abusive traffic, and bots. Returns geolocation, network owner, and a 0-100 threat score.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The IP address to analyze (IPv4 or IPv6).

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
ip?string
asn?
is_tor?boolean
is_vpn?boolean
is_bogon?boolean
is_proxy?boolean
location?
is_abuser?boolean
is_mobile?boolean
is_crawler?boolean
threat_score?integer
is_datacenter?boolean
Example Request
curl -X GET 'https://api.veille.io/v1/intelligence/ip?query=string'
Example Response
{  "ip": "82.64.12.193",  "asn": {    "asn": 3215,    "org": "France Telecom - Orange",    "type": "isp",    "descr": "Orange S.A.",    "active": true,    "domain": "orange.com",    "country": "FR"  },  "is_tor": false,  "is_vpn": false,  "is_bogon": false,  "is_proxy": false,  "location": {    "city": "Paris",    "state": "Ile-de-France",    "country": "France",    "latitude": 48.8566,    "timezone": "Europe/Paris",    "longitude": 2.3522,    "country_code": "FR"  },  "is_abuser": false,  "is_mobile": false,  "is_crawler": false,  "threat_score": 0,  "is_datacenter": false}