---
title: "Get a attack surface finding of a company."
method: GET
path: "/api/v2/companies/{id}/findings/attacksurface/{findingId}"
tags: ["Findings"]
---

# Get a attack surface finding of a company.

`GET /api/v2/companies/{id}/findings/attacksurface/{findingId}`

Attack surface is the technical analysis of open critical ports, out-of-date services, application weaknesses, SSL/TLS strength, and any misconfigurations. This information is gathered from Censys and Shodan databases and service/application versions are correlated with other subcategories' results.
 This category has 4% effect on total scan score.<br/><br/> For storage optimization, the system <b>permanently</b> deletes all findings that haven't been detected by the Black Kite scanner for over a year. Findings with manually changed statuses or associated tickets are excluded.

## Path parameters

- `id` integer, required
- `findingId` integer, required

## Response `200`

Success

- AttackSurfaceFinding
  - `FindingId` integer — The unique identifier of this finding.
  - `IPAddress` string — The related IP address which contains the finding.
  - `Severity` 'Info' | 'Low' | 'Medium' | 'High' | 'Critical' — The severity of a finding.
  - `Status` 'Active' | 'FalsePositive' | 'Suppressed' | 'Acknowledged' | 'Deleted' | 'Remediated' — The status of this finding. - Active, means the finding is still active with no review as of yet. - FalsePositive, means the finding is considered to be false alarm. - Suppressed, means the finding is suppressed, similar to FalsePositive. - Acknowledged, means the finding is accepted, for example will not be fixed. - Deleted, means the finding is deleted, similar to FalsePositive. - Remediated, means the finding is mitigated.
  - `Ticket` FindingTicketSummary — A summary information of a finding ticket.
    - `TicketId` number, nullable — The unique identifier of the ticket.
    - `Status` 'Unassigned' | 'Assigned' | 'In Progress' | 'Closed–Acknowledged' | 'Closed–Remediated' | 'Closed–False Positive' | 'On Hold' | 'Recheck' | 'Deleted' — The status of this ticket. A ticket is automatically in “Assigned” status when a user with admin rights assigns it to another user. Depending on the user type, tickets can have different statuses: In Progress, On Hold and Recheck. - Unassigned: No owner has been set; the ticket is pending assignment. - In progress: Means the user takes responsibility of the associated finding and in the remediation process. - On hold: Means the user is waiting for another action to be completed before s/he takes action with regards to the finding. - Recheck: Means the user has completed her/his progress about the finding and waits for the user who assigns the ticket (or follow-up user with admin rights) to close it. An admin user can set a ticket in seven different statuses, In Progress, On Hold, Recheck, Closed-Acknowledged, Closed-Remediated, Closed-False Positive, and Deleted. - Closed-Acknowledged: The definition is very similar to risk acceptance. This means no or limited action can be taken with regards to the finding. There is no way but to accept the risk of the finding. This could be due to an out-of-date system soon to be retired. - Closed–Remediated: The action right after the Recheck status. If a company user sets the ticket in Recheck status, it is then passed to the admin user for him/her to close the issue. Closed status means the issue is fixed. - Closed-False Positive: Indicates a reported issue was a false alarm upon investigation. No action needed, as it poses no genuine risk. - Deleted: As the name suggests, this deletes the ticket (not the finding). It does not necessarily mean the issue is fixed or risk is accepted.
    - `Owner` string, nullable — A ticket may have one or more owners. But this field contains the name or the email address of the first one.
  - `ControlId` string — The unique identifier of the control that this finding relates to.
  - `RiskScore` number, float — The addition of all related CWE and CVE scores. Attention: This field will deprecate.
  - `Domains` string[], nullable — The domains that live on the related IP Address
  - `Ports` integer[], nullable
  - `Protocols` string[], nullable
  - `Risk` string — HTML formatted finding details that constitute this finding.
  - `FindingDate` string, date-time — The date that Black Kite first seen the finding.
  - `ConfidenceLevel` 'Low' | 'Medium' | 'High' | 'VeryHigh', nullable — The confidence level of this finding.
  - `UpdateDate` string, date-time, nullable — The date that the finding was last updated.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/versions/7dadaba760fb/schema)