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
Key | Datatype | Required | Description |
---|---|---|---|
dataset | string | The name of the dataset to restrict the query | |
logged_after | number | A UNIX timestamp in milliseconds to restrict the results of the query to entries logged after this value. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
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"}