Assets

Search Assets

Search assets in a project, with filtering, sorting and pagination.

Filter with the filter field. Each field supports a subset of the operators eq, neq, in, nin, start, end and contains; see the request schema. in and nin take a list of values and are case sensitive.

The custom_tags filter supports two special cases:

  • "in": [] returns assets without any tags.
  • "*" as the eq value, or in the in list, returns assets with any project tag.

For pagination, pass meta.pagination.next_cursor from the previous response as pagination.next_cursor in the request. Sorting can't be changed while paginating.

By default only custom_tags is returned as enrichments. Specifying enrichments replaces that default.

post/projects/{project_id}/assets/_search

Request

  • Base URL
    https://api.securitytrails.com/v2
  • URL
    https://api.securitytrails.com/v2/projects/{project_id}/assets/_search
  • Auth
    API key in header apikey

Path parameters

project_idstring required

The ID of the project

Request body

enrichmentsAssetEnrichment[]

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.