---
title: "Get current DCI values"
method: GET
path: "/v1/objects/{object-id}/data-collection/current-values"
tags: ["Data Collection"]
---

# Get current DCI values

`GET /v1/objects/{object-id}/data-collection/current-values`

Retrieve current values for all data collection items (DCIs) of a given object.
Table DCIs are listed with `dataType` 6 (null) and an empty `value` - the table content itself is not returned.

## Path parameters

- `object-id` integer, required — Object ID

## Response `200`

Current DCI values retrieved successfully

- object
  - `objectId` integer — Object ID
  - `objectName` string — Object name
  - `values` DCIValue[]
    - `ownerId` integer — Object ID that owns this DCI
    - `id` integer — DCI ID
    - `name` string — DCI name
    - `flags` integer — DCI flags
    - `description` string — DCI description
    - `sourceType` integer — Data source type
    - `dataType` integer — Data type
    - `value` string — Current value as string
    - `timestamp` string, date-time, nullable — Timestamp of last value collection in ISO 8601 format with milliseconds, or null if no value was collected
    - `status` integer — Current DCI status
    - `type` integer — DCI type
    - `errorCount` integer — Number of consecutive collection errors
    - `lastCollectionError` 'SUCCESS' | 'COMM_ERROR' | 'NOT_SUPPORTED' | 'IGNORE' | 'NO_SUCH_INSTANCE' | 'COLLECTION_ERROR' | 'ACCESS_DENIED' | 'INVALID_DATA' | 'UNKNOWN' — Reason of the last data collection error (`SUCCESS` if last collection attempt was successful)
    - `templateItemId` integer — Template item ID if DCI is created from template
    - `unitName` string — Unit name for the value
    - `multiplier` integer — Value multiplier
    - `noValue` boolean — True if DCI has no collected value
    - `comments` string — DCI comments
    - `anomalyDetected` boolean — True if anomaly was detected in recent values
    - `userTag` string — User-defined tag
    - `thresholdDisableEndTime` integer — Time until which threshold processing is disabled (Unix timestamp), 0 if not disabled, -1 if disabled permanently
    - `mappingTableId` integer — ID of the value mapping table, 0 if none
    - `hasActiveThreshold` boolean — True if DCI has active threshold
    - `threshold` object — Active threshold information (present only if hasActiveThreshold is true)

## Other responses

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

## Changes

- **2026-09-01** `30f191c5eb8f` — 2 breaking, 2 info
  - the response property `values/items/timestamp` became nullable for the status `200`
  - the `values/items/timestamp` response's property type/format changed from `integer`/`` to `string`/`date-time` for status `200`
  - added the optional property `values/items/mappingTableId` to the response with the `200` status
  - added the optional property `values/items/thresholdDisableEndTime` to the response with the `200` status
- **2026-08-30** `5f2f9814926d` — 1 info
  - added the optional property `values/items/lastCollectionError` to the response with the `200` status

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/data-collection/current-values/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-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/30f191c5eb8f/schema)