---
title: "Query specific DCI summary table"
method: POST
path: "/v1/dci-summary-tables/{table-id}/query"
tags: ["DCI Summary Tables"]
---

# Query specific DCI summary table

`POST /v1/dci-summary-tables/{table-id}/query`

Execute a query on a specific DCI summary table.

## Path parameters

- `table-id` integer, required — Summary table ID

## Request body

- object
  - `objectId` integer — Root object ID for table query

## Response `200`

Summary table query executed successfully

- 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` — Invalid request or invalid summary table ID
- `401` — Unauthorized
- `403` — Access denied
- `500` — Query execution failed

## Changes

- **2026-06-10** `30e75dc6a94c` — 1 breaking, 7 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `500`
  - added the optional property `columns` to the response with the `200` status
  - …4 more
- **2026-05-08** `c6aaf3632e48` — 3 breaking, 5 warning
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `500`
  - removed the optional property `columns` from the response with the `200` status
  - …4 more

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/dci-summary-tables/:table-id/query/post.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-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/37e78a603eb9/schema)