For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Trebellar Platform
DocsGuidesAPI Reference
DocsGuidesAPI Reference
  • API Reference
    • Introduction
  • API Resources
      • GETList Assets with Filtering
      • POSTCreate New Asset
      • GETGet Asset by ID
      • POSTBulk Asset Operations
      • POSTBulk Seat Assignments by People Group
      • GETList Asset Tags
      • POSTAdd Asset Tag
      • PUTUpdate Asset Tag
      • DELDelete Asset Tag
      • POSTBind Asset Tags
      • POSTUnbind Asset Tags
      • GETList all Location Definitions
      • POSTAdd Location Definitions
      • PUTUpdate Location Definitions
      • DELDelete Location Definitions
Trebellar Platform
LogoLogo
API ResourcesAssets

Get Asset by ID

||View as Markdown|
GET
https://api.trebellar.app/api/v2/assets/:assetId
GET
/api/v2/assets/:assetId
1import { TrebellarApiClient } from "@trebellar/api-sdk";
2
3async function main() {
4 const client = new TrebellarApiClient({
5 apiKey: "YOUR_API_KEY_HERE",
6 });
7 await client.assets.getAssetById("eid:sfo-001");
8}
9main();
1{
2 "id": "st_sf_tower_01",
3 "label": "San Francisco Tower - Floor 42",
4 "parentId": "string",
5 "parentIdPath": [
6 "string"
7 ],
8 "location": {
9 "type": "Point",
10 "coordinates": [
11 -122.4194,
12 37.7749
13 ]
14 },
15 "dynamicProperties": {},
16 "assetTags": [
17 "string"
18 ],
19 "type": "string",
20 "staticProperties": {
21 "address": "123 Main St, San Francisco, CA 94105",
22 "coordinates": {
23 "lat": 37.7749,
24 "lon": -122.4194
25 },
26 "rentableSqft": 50000,
27 "businessHoursStart": "08:00",
28 "businessHoursEnd": "18:00",
29 "businessDays": [
30 "monday",
31 "tuesday",
32 "wednesday",
33 "thursday",
34 "friday"
35 ],
36 "status": "active",
37 "timezone": "America/Los_Angeles"
38 },
39 "children": [
40 null
41 ]
42}
Retrieve detailed information about a specific asset including its hierarchical children, static properties, and location data. This operation returns the complete asset structure with all nested children if they exist.
Was this page helpful?
Previous

Create New Asset

Next

Bulk Asset Operations

Built with

Authentication

X-Trebellar-Api-Keystring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

assetIdstringRequired

A unique identifier for an asset. Can be an AssetId or an ExternalId. ExternalIds are denoted by the “eid:” prefix.

Response

Asset retrieved successfully with complete hierarchical structure
Buildingobject
OR
Floorobject
OR
Spaceobject
OR
Deskobject
OR
Sensor Groupobject
OR
Sensorobject

Errors

400
Bad Request Error
404
Not Found Error