> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trassets.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Data API v1 Reference: Endpoints Overview

> Overview of the /v1/ endpoints: base URL, authentication, response headers, errors, and the unversioned endpoints that have no /v1/ counterpart.

The `/v1/` endpoints are the versioned interface to the same real-estate data. Base URL: `https://api.trassets.ai`. Send your API key in the `X-API-Key` header on every request. All responses are JSON.

Every `/v1/` response is a top-level JSON array — there is no wrapping envelope. See [Response Structure](/v1/response-shape-conventions) for the object, array, and code/label patterns the tables follow.

## Endpoint types

| Type               | Path pattern                 | Pagination                                            | Use case                                          |
| ------------------ | ---------------------------- | ----------------------------------------------------- | ------------------------------------------------- |
| Category endpoints | `/v1/{category}/{api_table}` | Offset-based (`limit` / `offset`) plus cursor support | Business queries, dashboards, incremental fetches |
| Raw endpoints      | `/raw/{table_name}`          | Cursor-based (`cursor` from `next_cursor` in body)    | Bulk sync, full exports, data warehousing         |

Raw endpoints are unversioned: they expose source tables below the modelled layer, so there is no `/v1/` variant.

### Response headers

Category endpoints return pagination metadata in headers, not in the body:

* `X-Total-Count` — total rows matching the query
* `X-Has-More` — `"true"` or `"false"`
* `X-Next-Offset` — the offset for the next page
* `X-Next-Cursor` — an opaque cursor when a full page is returned, on the endpoints that support cursor pagination; absent where the table has no cursor column, see [Pagination](/concepts/pagination)

## Error format

Errors follow [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) (`application/problem+json`). Every error object contains `type`, `title`, `status`, `detail`, and `instance`. See [Errors](/concepts/errors) for a full list of status codes and retry guidance.

## Versioning

Tables are migrated to `/v1/` one at a time, alongside the unversioned base path — both work today, with no redirect and no confirmed sunset date for unversioned paths yet. See [Versioning](/concepts/versioning) for the current rollout state.

## Endpoint groups

<CardGroup cols={2}>
  <Card title="Property" icon="building">
    Property objects, structure tree, technical objects, and creditor service assignments — see the **Property** group in the sidebar.
  </Card>

  <Card title="Contracts" icon="file-contract">
    Rental debits, debit differences, service contracts, and lease terms — see the **Contracts** group in the sidebar.
  </Card>

  <Card title="Accounting" icon="calculator">
    Accounts, budgets, and bookings — see the **Accounting** group in the sidebar.
  </Card>

  <Card title="Depreciation" icon="chart-line-down">
    Fixed assets and depreciation postings — see the **Depreciation** group in the sidebar.
  </Card>

  <Card title="Operations" icon="clipboard-list">
    Notifications and projects — see the **Operations** group in the sidebar.
  </Card>

  <Card title="Stakeholder" icon="users">
    Creditors, employees, owners, and tenants — see the **Stakeholder** group in the sidebar.
  </Card>
</CardGroup>

Not every unversioned table has a `/v1/` counterpart yet — `kontenmapping_ranges`, `offers`, and `orders` are still base-path only. [Data Model Overview](/v1/data-model/overview) lists what `/v1/` covers today.

## Unversioned endpoints

Four endpoint groups exist once for the whole API and carry no `/v1/` prefix. They are listed in the sidebar below the categories.

| Group      | Endpoint                                   | What to expect under `/v1/`                                                                                                                       |
| ---------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Catalog    | `GET /catalog`                             | Lists the **unversioned** categories and tables, not the `/v1/` set. Use [Data Model Overview](/v1/data-model/overview) for the `/v1/` inventory. |
| Delta Sync | `GET /changes`                             | Reports sync timestamps per table; the `endpoint_url` field points at unversioned paths. Requires a `since` parameter (ISO-8601 UTC).             |
| Meta       | `GET /meta/{api_table}/values/{column}`    | Lookup values for a column, where they are configured for your key. Returns `404 Not Found` with `"No lookup values configured"` otherwise.       |
| Raw Data   | `GET /raw/tables`, `GET /raw/{table_name}` | Source tables below the modelled layer — unaffected by the `/v1/` migration.                                                                      |