Get host event history

get

https://api.platform.censys.io/v3/global/asset/host/{host_id}/timeline

Retrieve event history for a host. A host ID is its IP address.

Note that when a service protocol changes after a new scan (for example, from UNKNOWN to NETBIOS), this information will be reflected in the scan object.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

host_id

string

required

The IP address of a host.

Query Params

organization_id

uuid

start_time

date-time

required

Start time of the host timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.

end_time

date-time

required

End time of the host timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.

Headers

X-Organization-ID

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_timeline_event.v1+json

Generated from available response content types

Allowed:

Responses

200OK

400Bad request

401Request does not contain a valid Authorization token

403User does not have permission to access this data

404Resource not found

500Internal server error