---
title: "getMonitoringTimeSeriesV2"
method: POST
path: "/v2/integrations/{integrationId}/monitoring/time-series"
tags: ["monitoring", "integrations"]
---

# getMonitoringTimeSeriesV2

`POST /v2/integrations/{integrationId}/monitoring/time-series`

Get time-series aggregated event counts from the unified erp_monitoring_v2 table.
Returns bucketed counts for chart rendering.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- GetMonitoringTimeSeriesV2Request
  - `from_date` string, date-time, required — Start of the time range (required)
  - `to_date` string, date-time — End of the time range (defaults to now)
  - `interval` '5m' | '10m' | '30m' | '1h' | '3h' | '1d', required — Time bucket interval
  - `use_case_type` 'inbound' | 'outbound' | 'file_proxy' | 'managed_call' | 'secure_proxy' — Filter by use case type
  - `group_by` 'use_case_type' | 'use_case' — Field to group the bucket breakdown by

## Response `200`

Time-series data retrieved successfully

- object
  - `interval` '5m' | '10m' | '30m' | '1h' | '3h' | '1d' — The bucket interval
  - `from_date` string, date-time
  - `to_date` string, date-time
  - `buckets` TimeSeriesBucketV2[]
    - `timestamp` string, date-time, required — Bucket start timestamp
    - `success_count` integer — Number of successful events in the bucket
    - `error_count` integer — Number of error events in the bucket
    - `warning_count` integer — Number of warning events in the bucket
    - `skipped_count` integer — Number of skipped events in the bucket
    - `total_count` integer, required — Total events in the bucket
    - `breakdown` TimeSeriesBreakdownItemV2[] — Statistics breakdown by the requested group_by field for this bucket
      - `use_case_type` 'inbound' | 'outbound' | 'file_proxy' | 'managed_call' | 'secure_proxy' — Present when grouping by use_case_type
      - `use_case_id` string — Present when grouping by use_case. Unknown historical IDs are collapsed into "__unknown__"
      - `success_count` integer, required — Number of successful events in the breakdown item
      - `error_count` integer, required — Number of error events in the breakdown item
      - `warning_count` integer, required — Number of warning events in the breakdown item
      - `skipped_count` integer, required — Number of skipped events in the breakdown item
      - `total_count` integer, required — Total events in the breakdown item

## 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/revisions/c24837d75096/schema)