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

List Assets with Filtering

||View as Markdown|
GET
https://api.trebellar.app/api/v2/assets
GET
/api/v2/assets
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.listAll({});
8}
9main();
1{
2  "data": [
3    {
4      "id": "st_sf_tower_01",
5      "label": "San Francisco Tower - Floor 42",
6      "parentId": "string",
7      "parentIdPath": [
8        "string"
9      ],
10      "location": {
11        "type": "Point",
12        "coordinates": [
13          -122.4194,
14          37.7749
15        ]
16      },
17      "dynamicProperties": {},
18      "assetTags": [
19        "string"
20      ],
21      "type": "string",
22      "staticProperties": {
23        "address": "123 Main St, San Francisco, CA 94105",
24        "coordinates": {
25          "lat": 37.7749,
26          "lon": -122.4194
27        },
28        "rentableSqft": 50000,
29        "businessHoursStart": "08:00",
30        "businessHoursEnd": "18:00",
31        "businessDays": [
32          "monday",
33          "tuesday",
34          "wednesday",
35          "thursday",
36          "friday"
37        ],
38        "status": "active",
39        "timezone": "America/Los_Angeles"
40      },
41      "children": [
42        null
43      ]
44    }
45  ]
46}

Retrieve a list of assets with optional filtering by asset type. This operation returns all assets accessible to the authenticated user, optionally filtered to start from a specific asset type level (e.g., only structures, only floors, etc.). Each asset includes its basic properties and immediate children.

Was this page helpful?
Previous

Introduction

Next

Create New Asset

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.

Query parameters

fromAssetTypeenumOptional

Asset type identifier defining the hierarchy level: ROOT (top-level), STRUCTURE (buildings), FLOOR (building levels), SPACE (rooms/areas), DESK (workstations), SENSOR (IoT devices), OTHER (sensor collections)

Response

Assets retrieved successfully, potentially filtered by type
datalist of objects

Errors

404
Not Found Error