Skip to main content
GET
TypeScript

Path Parameters

id
string<uuid>
required

Unique identifier of the finding

Response

A single FSPM finding

id
string<uuid>
required

Unique identifier of the finding

Example:

"2f8a132e-623d-3a97-841f-2c5d9b7a3e60"

status
enum<string>
required

Current status of the finding

Available options:
OPEN,
ACCEPTED,
RESOLVED
Example:

"ACCEPTED"

severity
enum<string>
required

Severity level of the finding

Available options:
INFO,
LOW,
MEDIUM,
HIGH
Example:

"MEDIUM"

category
enum<string>
required

Category of the finding

Available options:
USER_MANAGEMENT,
APPROVAL_GROUP_MANAGEMENT,
POLICY_ENGINE_UTILIZATION,
WORKSPACE_CONFIGURATION,
DEFI_ACCESS,
FLEET_MANAGEMENT
Example:

"USER_MANAGEMENT"

createdAt
string<date-time>
required

When the finding was first detected

Example:

"2026-07-21T07:49:28.000Z"

title
string
required

Human-readable title of the finding

Example:

"The API user 'Admin API' is missing an IP allowlist"

info
object
required

Additional structured context about the finding. Shape varies by finding type.

Example:
complianceReqs
object[]
required

Compliance requirements this finding relates to

Example:
riskExplanation
string
required

Explanation of the risk this finding represents

Example:

"This API user has no IP allowlist, so it can be accessed from anywhere, increasing the risk of unauthorized activity."

mitigationGuidance
string
required

Guidance on how to mitigate this finding

Example:

"Go to Developer Center > API Users, click the actions button (3 dots) next to the API user, and select 'Allowlist IP address'."

statusUpdatedAt
string<date-time>

When the finding status was last updated, omitted if the status was never updated

Example:

"2026-08-16T08:52:57.000Z"

statusUpdatedByUserId
string<uuid>

The user who last updated the finding status, omitted if the status was never updated

Example:

"7c2e3a4f-144d-4f23-932c-518b3d7f1a09"

statusUpdatedReason
string

The reason provided for the last status update, omitted if none was provided

Example:

"False positive, the API user only ever connects from a fixed, trusted network"