List Discovered Asset's Logs

GET 
/discovery/assets/:parent_lookup_discovery_asset/logs/

Request

Path Parameters

discovery_asset_id stringrequired

Identifier of the discovery asset.
A unique Base58 value identifying this object.

parent_lookup_discovery_asset stringrequired

Query Parameters

event_type string[]
Possible values: [domain, first_seen, ip, note, owner, risk, scan, score, screenshot, technology]
Type of event to filter results:
• first_seen - First Seen
• domain - Domain
• ip - IP
• risk - Risk
• screenshot - Screenshot
• scan - Scan
• note - Note
• owner - Owner
• score - Score
• technology - Technology
length integer

Number of results to return per page.

ordering string

Which field to use when ordering the results.

page integer

A page number within the paginated result set.

search string

A search term.

Responses

200

application/json

Schema

Schema

count integer

Total number of results.

page_total integer

Total number of pages.

page integer

Number of the current page.
The first page is 1.
Defaults to 1 if no specific page is requested.

length integer

Number of results returned per page.

results

object[]

Array [

id stringrequired

A unique Base58 value identifying this object.

change stringrequired

Type of change made to the log:

• created - Created.
• changed - Changed.
• deleted - Deleted.
• comment - Commented.

changed date-timerequired

Timestamp of the most recent change to the discovery asset, in ISO 8601 UTC format.
For example, "2023-08-09T13:27:43.8208302

changed_by

object

required

User responsible for the log entry.

id stringrequired

A unique Base58 value identifying this object.

email email

Possible values: <= 254 characters

Email of the user.

name stringrequired

Name of the user.

field stringnullable

Possible values: <= 50 characters

Field that changed in the discovered asset.

value required

The current value of the changed field in the discovered asset.

old_value required

The previous value of the changed field in the discovered asset.

message stringrequired

Logged message, which can include HTML tags.
For example, "<strong>Scan</strong> performed.".

history_type stringrequired

Possible values: [+, -, ~]

Type of change made to the discovery asset.

• + - +
• - - -
• ~ - ~

]

Example (from schema)

{
  "count": 6,
  "page_total": 1,
  "page": 1,
  "length": 10,
  "results": [
    {
      "id": "string",
      "change": "string",
      "changed": "2024-07-29T15:51:28.071Z",
      "changed_by": {
        "id": "string",
        "email": "[email protected]",
        "name": "string"
      },
      "field": "string",
      "message": "string",
      "history_type": "+"
    }
  ]
}

400

application/json

Schema

Schema

<field name> string[]
non_field_errors string[]

Example (from schema)

{
  "<field name>": [
    "Errors related to field <field name>."
  ],
  "non_field_errors": [
    "Errors not related to any field specific field."
  ]
}

401

application/json

Schema

Schema

detail string

Example (from schema)

{
  "detail": "Incorrect authentication credentials."
}

500

application/json

Schema

Schema

detail string

Example (from schema)

{
  "detail": "Unexpected error while handling your request."
}

Loading...