Exposures

List Exposures

Retrieve the exposure signatures found on assets in the project, along with the count of affected assets for each signature. The list can be filtered by CVE, CVSS score, CWE or severity, or searched with query.

The result is sorted by signature severity in descending order.

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

get/projects/{project_id}/exposures

Request

  • Base URL
    https://api.securitytrails.com/v2
  • URL
    https://api.securitytrails.com/v2/projects/{project_id}/exposures
  • Auth
    none declared

Path parameters

project_idstring required

The ID of the project

Query parameters

limitinteger

The number of exposures

filter_cve_idstring nullable

Filter for exposure tied to a vulnerability with the provided CVE

Example:CVE-2024-6387
filter_cvss_score_gtenumber nullable

Filter for exposures tied to a vulnerability with the provided CVSS score greater or equal

filter_cvss_score_ltenumber nullable

Filter for exposures tied to a vulnerability with the provided CVSS score less or equal

filter_cwe_idstring nullable

Filter for exposure tied to a vulnerability associated with the provided CWE

Example:CWE-79
filter_severity'informational' | 'moderate' | 'critical'

DEPRECATED: Use filter_severity_exact or filter_severity_min instead

filter_severity_exact'informational' | 'moderate' | 'critical'

Filter for exposures which have the exact provided severity

filter_severity_min'informational' | 'moderate' | 'critical'

Filter for exposures which have at least the provided severity

cursorstring nullable

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

querystring nullable

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.

Response

Successful Response

Changes

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