---
title: "POST /openapi/v1/uns/history"
method: POST
path: "/openapi/v1/uns/history"
tags: ["openapi/v1/uns", "openapiV1Uns"]
---

# POST /openapi/v1/uns/history

`POST /openapi/v1/uns/history`

## Request body

- HistoryReq
  - `topics` string[], required
  - `start_time` string, required
  - `end_time` string, required
  - `aggregation` HistoryAggregation
    - `interval` string, required
    - `function` string
    - `field` string
    - `fields` HistoryAggregationField[]
      - `name` string, required
      - `function` string
  - `page` integer
  - `size` integer

## Response `200`

A successful response.

- object
  - `code` integer
  - `msg` string
  - `data` HistoryResp
    - `success` boolean, required
    - `results` OpenapiHistoryItem[], required
      - `success` boolean, required
      - `topic` string, required
      - `result` OpenapiHistoryResult
        - `values` OpenapiHistoryValue[], required
          - `value` object
          - `quality` string, required
          - `timeStamp` integer, required
        - `meta` HistoryQueryMeta
          - `aggregated` boolean, required
          - `sampled` boolean, required
          - `rawTotal` integer, required
          - `returnedTotal` integer, required
          - `requestedIntervalMs` integer
          - `actualIntervalMs` integer
          - `strategy` string
      - `error` OpenapiItemError
        - `code` integer, required
        - `message` string, required
    - `page` integer, required
    - `size` integer, required
    - `total` integer, required

---

[API](https://skmtc.net/freezonex/apis/untitled-api.md) · [All operations](https://skmtc.net/freezonex/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freezonex/untitled-api/revisions/e5f616b215c8/schema)