---
title: "Import Historic Data"
method: POST
path: "/v1/monitors/import-historic/{monitorId}"
tags: ["Monitors"]
---

# Import Historic Data

`POST /v1/monitors/import-historic/{monitorId}`

Import historic data for the monitor. Full documentation at https://docs.metaplane.dev/docs/importing-historical-data#limitations. Setting `isPreview` to  true will validate the import without actually inserting data.

## Path parameters

- `monitorId` string, uuid, required

## Request body

- ImportHistoricDataRequest
  - `dataPoints` PublicSeriesPointWithTimestamp[]
    - `value` number, double
    - `groups` object, nullable — Each key is a group name and each value should be the group by value. Omit the monitor has no groups
    - `timestamp` string, date-time — ISO 8601 date time offset e.g. 2023‐09‐07T06:18:56−07:00 or 2023‐09‐07T13:18:56Z
  - `isPreview` boolean, nullable — Optional flag to allow previewing what the result of the import would be. Setting to true will validate the import without actually inserting data

## Response `200`

Success

- PublicImportResult
  - `totalDataPoints` integer
  - `totalValidDataPoints` integer
  - `groupByValues` string[]
  - `filterReasonCounts` object

---

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