List Signatures

get

https://api.securitytrails.com/v2/projects/{project_id}/signatures

List signatures matching the given filters.

Unlike /exposures, signatures don't need to be related to an asset in the project, and don't include affected asset information.

If next_cursor is present in the response, it can be used to fetch the next page of results by passing it as cursor.

Path Params

project_id

string

required

The ID of the project

Query Params

limit

integer

1 to 1000

Defaults to 100

The number of signatures

filter_cve_id

^CVE-

Filter for signatures tied to a vulnerability with the provided CVE

filter_severity_exact

ExposureSeverity | null

Filter for signatures which have the exact provided severity

filter_severity_min

enum

Filter for signatures which have at least the provided severity

sort_by

string

enum

Defaults to added_at

The field to sort by

Allowed:

sort_direction

string

enum

Defaults to desc

The direction to sort by.

Allowed:

cursor

Integer offset for pagination. Pass the value from next_cursor in the previous response to fetch the next page.

query

length ≤ 100

Free-text search matched against the signature's name and ID. If given in YYYY-MM-DD format, also matches signatures by the date they were added.

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Response

422Validation Error