Get started with the Data API v1

This guide gets you from zero to a successful /v1/ API call in a few minutes. You need a Unix-like shell with curl installed.

Request an API key

Trassets sets up the portal access for your organization (no public sign-up). Log in at portal.api.trassets.ai, generate an API key yourself and store it securely. The plaintext key is shown only once.

Make your first request

Set your key as an environment variable and query technical_objects — a table from the Property category.

export TRASSETS_API_KEY="sk_live_…"
curl "https://api.trassets.ai/v1/property/technical_objects?limit=1" \
  -H "X-API-Key: $TRASSETS_API_KEY"

The API returns a JSON object: the rows are in data, followed by count, next_cursor (null on the last page) and total (null unless you send include_total=true). A typical response looks like this:

{
  "data": [
    {
      "technical_object_id": 5231,
      "property_id": 1622,
      "floor_area_id": null,
      "name": "Aufzug Hof",
      "type": "Aufzug",
      "built_date": "1998-06-01",
      "is_meter": false
    }
  ],
  "count": 1,
  "next_cursor": "eyJjb2wiOiAi…",
  "total": null
}

See the v1 data model overview for how technical_objects joins to the rest of /v1/.

Success! You have authenticated and fetched your first row of data from a /v1/ endpoint.

Next steps

Read Authentication for key management and access tiers.
Check the v1 Overview for an overview of the /v1/ tables.
Read Response Structure for the structural rules every /v1/ response follows.
Browse the v1 Data Model pages for the field reference of each table.

Get Started

Core Concepts

Guides

Data Model

Get started with the Data API v1