Skip to main content
POST
security.host.lookup

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
ip
string
required

Public IPv4 or IPv6 address.

Minimum string length: 1
atTime
string<date-time>

Timestamp with a timezone, in ISO 8601.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
includeBanners
boolean
default:false

Include inert banners and certificate subjects, which may contain personal names.

includeHistory
boolean
default:false

Include all available historical observations, rather than one snapshot.

Response

The result

ip
required

Observed IP address.

Pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$
services
object[]
required

Up to 1000 observed services.

Maximum array length: 1000
truncated
boolean
required

True if observations or text were shortened.

hostnames
string[]

Observed hostnames.

Observed hostname.

Maximum string length: 4096
domains
string[]

Observed domains.

Observed domain.

Maximum string length: 4096
location
object

Approximate observed location.

network
object

Network facts.

operatingSystem
string

Observed operating system.

Maximum string length: 4096
cpes
string[]

Observed software identifiers.

Public software identifier.

Maximum string length: 4096
vulnerabilities
string[]

Host-level observed vulnerability identifiers.

Public vulnerability identifier.

Pattern: ^CVE-\d{4}-\d{4,}$
matchedServices
object[]

Matching service descriptors, only when known.

Maximum array length: 1000