Get IP intelligence data
Retrieves comprehensive information about an IP address including threats, geolocation, and network details
curl --request GET \
--url https://api.customeros.ai/verify/v1/ip \
--header 'X-CUSTOMER-OS-API-KEY: <api-key>'{
"ip": {
"geolocation": {
"city": "Berlin",
"country": "Germany",
"countryIso": "DE",
"isEuropeanUnion": true
},
"ipAddress": "192.168.1.1",
"network": {
"asn": "AS12345",
"domain": "isp.com",
"name": "ISP Name",
"route": "192.168.0.0/16",
"type": "business"
},
"organization": {
"domain": "company.com",
"linkedin": "https://linkedin.com/company/company",
"name": "Company Name"
},
"threats": {
"isCloudRelay": false,
"isDatacenter": false,
"isMobile": false,
"isProxy": false,
"isTor": false,
"isUnallocated": false,
"isVpn": false
},
"time_zone": {
"abbr": "<string>",
"current_time": "2024-09-10T14:00:00+01:00",
"is_dst": true,
"name": "<string>",
"offset": "+0100"
}
},
"requestId": "1234567890abcdef",
"status": "success"
}Authorizations
Query Parameters
IP address to analyze
Response
Response containing IP intelligence data including threats, geolocation, and network information
IP intelligence details required: true
Geolocation information required: true
City name required: false
"Berlin"
Country name required: true
"Germany"
ISO 3166-1 alpha-2 country code required: true pattern: ^[A-Z]{2}$
"DE"
Indicates if country is in the European Union required: true
true
IP address being analyzed required: true pattern: ^(?:[0-9]{1,3}.){3}[0-9]{1,3}$
"192.168.1.1"
Network information required: true
Autonomous System Number required: true pattern: ^AS\d+$
"AS12345"
Network domain required: false
"isp.com"
Network name required: true
"ISP Name"
Network route (CIDR notation) required: true pattern: ^(\d{1,3}.){3}\d{1,3}/\d{1,2}$
"192.168.0.0/16"
Network type required: true enum: business,hosting,isp,education,government
"business"
Organization information required: false
Threat intelligence information required: true
Indicates if IP is a cloud relay required: true
false
Indicates if IP belongs to a datacenter required: true
false
Indicates if IP belongs to a mobile network required: true
false
Indicates if IP is a proxy required: true
false
Indicates if IP is a TOR exit node required: true
false
Indicates if IP is unallocated required: true
false
Indicates if IP is a VPN required: true
false
Timezone information required: true
Timezone abbreviation required: true example: CET
Current time in the timezone required: true format: date-time
"2024-09-10T14:00:00+01:00"
Indicates if daylight saving time is active required: true
true
IANA timezone name required: true example: Europe/Berlin
UTC offset required: true pattern: ^[+-]\d{4}$
"+0100"
"1234567890abcdef"
Status indicates the result of the operation ("success" or "error")
"success"
curl --request GET \
--url https://api.customeros.ai/verify/v1/ip \
--header 'X-CUSTOMER-OS-API-KEY: <api-key>'{
"ip": {
"geolocation": {
"city": "Berlin",
"country": "Germany",
"countryIso": "DE",
"isEuropeanUnion": true
},
"ipAddress": "192.168.1.1",
"network": {
"asn": "AS12345",
"domain": "isp.com",
"name": "ISP Name",
"route": "192.168.0.0/16",
"type": "business"
},
"organization": {
"domain": "company.com",
"linkedin": "https://linkedin.com/company/company",
"name": "Company Name"
},
"threats": {
"isCloudRelay": false,
"isDatacenter": false,
"isMobile": false,
"isProxy": false,
"isTor": false,
"isUnallocated": false,
"isVpn": false
},
"time_zone": {
"abbr": "<string>",
"current_time": "2024-09-10T14:00:00+01:00",
"is_dst": true,
"name": "<string>",
"offset": "+0100"
}
},
"requestId": "1234567890abcdef",
"status": "success"
}