---
title: "List Asset Exposures"
method: GET
path: "/projects/{project_id}/assets/{asset_id}/exposures"
tags: ["Assets"]
---

# List Asset Exposures

`GET /projects/{project_id}/assets/{asset_id}/exposures`

## Request

- Base URL: `https://api.securitytrails.com/v2`
- URL: `https://api.securitytrails.com/v2/projects/{project_id}/assets/{asset_id}/exposures`
- Auth: none declared

Retrieve the list of exposures for an asset. Each exposure includes its `signature`, `vulnerabilities`,
the `instances` with the port it was present on, and more as described by response schema.

## Path parameters

- `asset_id` string, required: The asset identifier (domain or IP)
- `project_id` string, required: The ID of the project

## Response `200`

Successful Response

- ApiListResponseAssetExposure
  - `data` AssetExposure[], required
    - `asset_id` string, required
    - `instances` ExposureInstance[], nullable
      - `port_number` integer, required
      - `evidence_identifiers` string[], nullable
    - `details` object, nullable, required
    - `evidence_identifiers` string[], nullable
    - `signature` ExposureSignatureResponse, required
      - `id` string, required
      - `name` string
      - `description` string, nullable
      - `severity` union, required
        - 'informational' | 'moderate' | 'critical'
        - string
      - `remediation_steps` object, nullable
      - `added_at` string, date-time, nullable: Date when this signature was added to ASI
      - `references` string[], nullable
      - `vulnerabilities` VulnerabilityPublic[]
        - `name` string, required
        - `cve_id` string, required: The Common Vulnerabilities and Exposures (CVE) identifier for this vulnerability.
        - `cwe_ids` string[]: Common Weakness Enumeration (CWE) IDs associated with this vulnerability
        - `cvss_score` number, nullable
  - `meta` ApiMeta, required
    - `params` object, nullable
    - `counts` ApiCount
      - `total` integer, nullable
      - `returned` integer, required
    - `pagination` PaginationResponse
      - `next_cursor` string, nullable: An opaque value which should be passed as the `cursor` to retrieve the nextpage of results
      - `limit` integer, nullable: The number of items returned
      - `total` integer, nullable
      - `sort` array[], nullable: The sort order of the results
        - unknown[]
          - unknown
    - `request_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/securitytrails/apis/asi-project-api.md) - [All operations](https://skmtc.dev/securitytrails/apis/asi-project-api/llms.txt) - [OpenAPI document](https://skmtc.dev/securitytrails/apis/asi-project-api/revisions/71340c041238?raw)