Skip to main content
GET
Get one asset by its public id.

Authorizations

Authorization
string
header
required

Bearer access token obtained from /oauth/token.

Path Parameters

id
string<uuid>
required

Response

200 - application/json

OK

Public asset. The id is an opaque public reference (never the internal PK); for EMPLOYEE-category rows it is the stable employee UUID. Category-specific fields are populated only for their owning category; completeStatus is read-only.

accountId
string

Cloud account id (CLOUD assets).

Example:

"123456789012"

categoryKey
enum<string>

Asset category key.

Available options:
CLOUD,
COMPUTER,
CUSTOM,
INFORMATION,
EMPLOYEE
Example:

"CLOUD"

classification
string

Data classification.

Example:

"CONFIDENTIAL"

completeStatus
enum<string>
read-only

Read-only completeness status. COMPLETE when an owner is assigned, else INCOMPLETE. Applies to all categories.

Available options:
COMPLETE,
INCOMPLETE
Example:

"COMPLETE"

createdAt
string<date-time>

Creation timestamp (UTC).

Example:

"2026-01-15T09:30:00.000Z"

dataStored
object

User/patient-data flags for INFORMATION/CUSTOM assets. Read-only.

description
string

Governance description.

Example:

"Primary production web server."

email
string

Employee email - PII, surfaced under inventory:read (EMPLOYEE assets).

Example:

"jane.doe@example.com"

externalId
string

Identifier of the asset in its source system.

Example:

"i-0abc123def456"

id
string<uuid>

Opaque public asset id (UUID).

Example:

"3f1c9a2e-8b4d-4e7a-9c1f-2a5b6c7d8e9f"

lastCheckedAt
string<date-time>

Timestamp of the last compliance check (UTC), where applicable.

Example:

"2026-06-30T02:00:00.000Z"

name
string

Asset display name.

Example:

"prod-web-01"

osVersion
string

Operating system family and version, combined (COMPUTER assets).

Example:

"macOS 14.5"

ownerId
string<uuid>

Owner's employee UUID.

Example:

"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

ownerSource
string

Origin of the owner assignment.

Example:

"MANUAL"

region
string

Cloud region/location (CLOUD assets).

Example:

"eu-central-1"

serialNumber
string

Hardware serial number (COMPUTER assets).

Example:

"C02XY1234ABC"

tags
object[]

Structured tags on the asset.

type
string

Asset type within its category.

Example:

"SERVER"