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

# Get DCI historical data

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

Returns historical data for the specified DCI.
Time range can be specified using from/to timestamps, timeInterval, or itemCount.
If no parameters provided, returns last hour of data.

## Path parameters

- `object-id` string, required
- `dci-id` string, required

## Query parameters

- `from` integer
- `to` integer
- `timeInterval` integer
- `itemCount` integer
- `outputFormat` 'RowColumn' | 'ColumnRow' | 'InstanceColumnRow'

## Response `200`

Historical data

- DataSeries
  - `nodeId` integer
  - `dciId` integer
  - `values` object[]
    - `timestamp` integer
    - `value` union
      - string
      - number
      - object

## Other responses

- `401` — Access denied

## Changes

> 15 revisions in range; 12 could not be searched.

- **2023-02-23** `9c09a2aad349` — 1 breaking
  - api path removed without deprecation

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

---

[API](https://skmtc.dev/netxms/apis/netxms-rest-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netxms/netxms-rest-api/revisions/04789afedcb3/schema)