API Reference

Retrieve multiple hosts

post
https://api.platform.censys.io/v3/global/asset/host

Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
date-time

RFC3339 Timestamp to view all requested hosts at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.

host_ids
array of strings | null
required

A list of host IP addresses.

host_ids*
Query Params
uuid

The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the Getting Started docs for more information.

Headers
uuid

The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

string
enum
Defaults to application/vnd.censys.api.v3.host.v1+json

Generated from available response content types

Allowed:
Responses

Updated 7 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.censys.api.v3.host.v1+json
application/problem+json
application/json

Updated 7 months ago