Skip to main content
GET
Get one asset

Updated 23 Oct 2026 15:20 · page 4e705ba

Authorizations

Authorization
string
header
required

Mint a token from the portal at Settings → API tokens. Send it as Authorization: Bearer avb_... on every request. Query-string tokens are NOT accepted — the URL ends up in access logs.

Path Parameters

id
string<uuid>
required

Asset id (UUID).

Response

The asset.

id
string<uuid>
required
name
string
required
category
string
required

Free-text with an application-layer allowlist (display, camera, audio, conferencing, control_panel, touch_panel, cable, mount, rack, remote, microphone, speaker, projector, screen, computer, furniture, storage, other).

status
enum<string>
required
Available options:
in_service,
in_storage,
retired,
in_repair
monitored
boolean
required

True when a monitored device row is linked to this asset. See device_id for the pairing.

asset_tag
string

Customer-assigned inventory tag (e.g. AV-042).

manufacturer
string
model
string
serial_number
string
purchase_date
string

ISO date, YYYY-MM-DD.

warranty_end_date
string

ISO date, YYYY-MM-DD.

notes
string
room_id
string<uuid>

Absent when the asset is unplaced (in-storage / decommissioned).

room
string
building_id
string<uuid>
building
string
device_id
string<uuid>

The paired device id when monitored is true — use it against /pub/v1/devices/{id} for live telemetry.

created_at
string<date-time>
updated_at
string<date-time>