Global Data

Retrieve multiple hosts

Changed on Nov 3, 2026

Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to look up multiple IPs from an alert, log, or threat feed in one call, so you can triage a whole indicator list quickly.

post/v3/global/asset/host

Request

Base URL
https://api.platform.censys.io
URL
https://api.platform.censys.io/v3/global/asset/host
Auth
HTTP bearer

Query parameters

organization_idstring uuid

Example:11111111-2222-3333-4444-555555555555

Headers

X-Organization-IDstring 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.

Example:11111111-2222-3333-4444-555555555555

Request body

at_timestring 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_idsstring[] nullable required

A list of host IP addresses.

Example request

{
  "at_time": "2025-01-01T00:00:00Z"
}

Response

Changes

Nov 3, 2026ec1686b0a36a Revision changes
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- breaking
  the /////// response's property format changed from utf8 to no format for status
- breaking
  the /////// response's property format changed from utf8 to no format for status
- breaking
  the ////// response's property format changed from utf8 to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ////// response's property format changed from utf8 to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status

Operation history