Get the changes logged in the different datasets of an IP address.

GET {{baseUrl}}/v1/log/ip/:ip_address?dataset=W00P3&logged_after=-23837943

What

Obtain a list of changes logged in the different datasets of the IP address given.

Parameters

The endpoint accepts the following parameters in the path: - ip_address: (Mandatory) The public IPv4 or IPv6 addresses to be queried.

The endpoint accepts the following parameters in the query string: - dataset: (Optional) Name of the dataset to filter the query. If not given, then all datasets are queried. If given, then only the changes logged in the given dataset are returned. The list of datasets is obtained from the /v1/dataset/ip endpoint. - logged_after: (Optional) The UNIX timestamp in milliseconds of the earliest date to be included in the query. If not given, then the earliest date is the date of the first change logged in the dataset.

Result

The result is a JSON object with the following structure: - self: the URI of the API call - logs: The list of log changes. Each element of the list is a JSON object of a specific log change with the structure described in the endpoint /v1/log/ip/id/logchange_id.

Errors

The endpoint will return the following errors: - a 400 Bad Request error if the IP address is not public. - a 400 Bad Request error if the timestamp is in the future. - a 400 Bad Request error if the dataset is not a string that can have numbers, upper and lower case letters, and underscores. - a 404 Not Found error if the dataset was not found. - a 422 Unprocessable Entity error if the IP address is malformed.

It will also return the API Global errors described in the API description.

Request Params

KeyDatatypeRequiredDescription
datasetstringThe name of the dataset to restrict the query
logged_afternumberA UNIX timestamp in milliseconds to restrict the results of the query to entries logged after this value.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"logs":[{"risk":"MEDIUM","dataset":"cil","source":"tempor est elit mollit","lapse":"6H","action":"ADD","timestamp":20198319,"self":"cupidatat pariatur mollit","cidr":"et tempor","score":45209255},{"risk":"MEDIUM","dataset":"","source":"consectetur et","lapse":"180D","action":"DELETE","timestamp":-94347207,"self":"et","cidr":"Excepteur esse incididunt aute","score":54917967}],"self":"irure culpa"}