Global Data

Retrieve information about a single host. A host ID is its IP address.<br><br>In a SOC environment, use this endpoint to pull the current services, software, certificates, and labels on an IP from an alert, so you can quickly judge whether it is malicious or benign.

get/v3/global/asset/host/{host_id}

Request

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

Path parameters

host_idstring ip required

The IP address of a host.

Example:8.8.8.8

Query parameters

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.

Example:11111111-2222-3333-4444-555555555555
at_timestring date-time

RFC3339 Timestamp to view a host 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.

Example:2025-01-01T00:00:00Z

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

Response

OK

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