---
title: "getMonitoringTimeSeries"
method: POST
path: "/v1/integrations/{integrationId}/monitoring/timeseries"
tags: ["monitoring", "integrations"]
---

# getMonitoringTimeSeries

`POST /v1/integrations/{integrationId}/monitoring/timeseries`

Get time-series aggregated event counts for monitoring charts.
Returns pre-bucketed counts at configurable intervals for both inbound and outbound events.
Maximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- GetMonitoringTimeSeriesRequest
  - `from_date` string, date-time, required — Start date for the time series (inclusive)
  - `to_date` string, date-time — End date for the time series (inclusive). Defaults to current time if not specified.
  - `interval` '5m' | '10m' | '30m' | '1h' | '3h' | '1d', required — The time bucket interval for aggregation
  - `direction` 'inbound' | 'outbound' | 'both' — Filter by event direction. Defaults to both.

## Response `200`

Time-series aggregated event counts retrieved successfully

- object
  - `interval` '5m' | '10m' | '30m' | '1h' | '3h' | '1d', required — The time bucket interval used for aggregation
  - `from_date` string, date-time, required — Start date of the time series
  - `to_date` string, date-time, required — End date of the time series
  - `buckets` TimeSeriesBucket[], required — List of time-series buckets with event counts
    - `timestamp` string, date-time, required — The start timestamp of the bucket
    - `inbound` object, nullable — Inbound event counts for this bucket. Null when direction is outbound.
      - `success_count` integer
      - `error_count` integer
      - `warning_count` integer
      - `skipped_count` integer
      - `total_count` integer
    - `outbound` object, nullable — Outbound event counts for this bucket. Null when direction is inbound.
      - `success_count` integer
      - `error_count` integer
      - `pending_count` integer
      - `total_count` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/versions/c24837d75096/schema)