IP Information REST Reference

/ipInfo

Methods

GET

Gets the IP information from the current user

NOTE: This will return ipInfo for the first repository. To specify a particular repository, see /repository/{id}/ipInfo::GET

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*ip
*repositoryID
repositories
repository
score
total
severityInfo
severityLow
severityMedium
severityHigh
severityCritical
macAddress
policyName
pluginSet
netbiosName
dnsName
osCPE
biosGUID
tpmID
mcafeeGUID
lastAuthRun
lastUnauthRun
severityAll
os
hasPassive
hasCompliance
lastScan
links

Legend

* = always comes back

Request Parameters
Expand

Parameters must be passed in as query string (as opposed to JSON) in the format of: /ipInfo?ip="1.1.1.1"&dnsName="foo"

{
	"ip" : <string> (valid ip address),
	"dnsName" : <string> OPTIONAL
}
Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"repositories" : [
			{
				"id" : "2",
				"name" : "Rep2",
				"description" : ""
			}
		],
		"ip" : "192.168.1.75",
		"repositoryID" : "2",
		"score" : "2130",
		"total" : "322",
		"severityInfo" : "110",
		"severityLow" : "7",
		"severityMedium" : "41",
		"severityHigh" : "152",
		"severityCritical" : "12",
		"macAddress" : "00:00:00:00:00:00",
		"policyName" : "",
		"pluginSet" : "",
		"netbiosName" : "TARGET\\WIN7X64",
		"dnsName" : "win7x64.target.domain.com",
		"osCPE" : "cpe:\/o:microsoft:windows_7::gold:x64-ultimate",
		"biosGUID" : "",
		"tpmID" : "",
		"mcafeeGUID" : "",
		"lastAuthRun" : "",
		"lastUnauthRun" : "",
		"severityAll" : "12,152,41,7,110",
		"os" : "Microsoft Windows 7 Ultimate",
		"hasPassive" : "No",
		"hasCompliance" : "No",
		"lastScan" : "1408294249",
		"links" : [
			{
				"name" : "SANS",
				"link" : "https:\/\/isc.sans.edu\/ipinfo.html?ip=192.168.1.75"
			},
			{
				"name" : "ARIN",
				"link" : "http:\/\/whois.arin.net\/rest\/ip\/192.168.1.75"
			}
		],
		"repository" : {
			"id" : "2",
			"name" : "Rep2",
			"description" : ""
		}
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1409848524
}