---
title: "Get last collected value of table DCI"
method: GET
path: "/v1/objects/{object-id}/data-collection/{dci-id}/table-value"
tags: ["Data Collection"]
---

# Get last collected value of table DCI

`GET /v1/objects/{object-id}/data-collection/{dci-id}/table-value`

Retrieve last collected value of a table DCI (Data Collection Item) together with its collection timestamp.
If no value has been collected yet, both `timestamp` and `table` are `null`.

## Path parameters

- `object-id` integer, required — Object ID
- `dci-id` integer, required — DCI (Data Collection Item) ID

## Response `200`

Last collected table value retrieved successfully

- object
  - `id` integer — DCI ID
  - `description` string — DCI description
  - `timestamp` string, date-time, nullable — Collection timestamp of the returned value (ISO 8601), `null` if no value collected yet
  - `table` TableData — Tabular query result (serialized NetXMS Table).
    - `extendedFormat` boolean — Whether the table uses extended format (per-cell status and row metadata)
    - `source` integer — Data source identifier
    - `title` string — Table title
    - `columns` object[] — Column definitions
      - `name` string
      - `dataType` integer
      - `displayName` string
      - `instanceColumn` boolean
      - `unitName` string
      - `multiplier` integer
      - `useMultiplier` integer
    - `data` object[] — Table rows
      - `objectId` integer — Source object ID (present only in extended format when set)
      - `baseRow` integer — Base row index (present only when set)
      - `values` object[] — Cell values, one per column
        - `status` integer — Cell status (present only when not the default)
        - `value` string — Cell value

## Other responses

- `400` — Object is not data collection target or DCI is not a table DCI
- `401` — Unauthorized
- `403` — User does not have read access to given object
- `404` — Object or DCI with given ID does not exist

## Changes

- **2026-09-08** `133088d0d956` — 1 breaking
  - the `table` response's property type changed from no type to `object` for status `200`
- **2026-09-08** `c2492179ed18` — 1 breaking
  - the `table` response's property type changed from `object` to no type for status `200`
- **2026-09-07** `3aeada4e28f8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/data-collection/:dci-id/table-value/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/8bda44a3ac0b?raw)