---
title: "Get Metric Data"
method: POST
path: "/beta/analytics/metrics"
tags: ["Analytics"]
---

# Get Metric Data

`POST /beta/analytics/metrics`

Get data of a specific metric (aggregated)

## Request body

- union
  - GetMetricDataInputCsidFilter
    - `id` string, required
    - `csidFilter` integer[]
    - `filters` Filter[]
      - `attribute` string, required
      - `values` string[]
    - `aggregations` string[]
    - `timezone` string, required
  - GetMetricDataInputPeriodFilter
    - `id` string, required
    - `periodFilter` union, required
      - Interval
        - `start` string, date-time, required
        - `end` string, date-time, required
      - Preset
        - `value` string, required — values: [PreviousQuarter, ThisWeek, PreviousWeek, Yesterday, Today, ThisMonth, PreviousMonth, ThisQuarter, ThisYear]
    - `filters` Filter[]
      - `attribute` string, required
      - `values` string[]
    - `aggregations` string[]
    - `timezone` string, required

## Response `200`

The metric data

- GetMetricDataOutput
  - `data` MetricData, required
    - `id` string, required
    - `aggregates` AggregateValue[]
      - union
        - AgentPresenceDurationValue
          - `value` PresenceDuration[]
            - `value` number, double, required
            - `status` Status, required
              - …
          - `description` string
        - DoubleAggregateValue
          - `value` number, double, required
          - `measure` string, required — values: [Min, Max, Sum, Percentage, AgentPresenceDuration, StdDev, Average]
        - LongAggregateValue
          - `value` integer, required
          - `measure` string, required — values: [Count]

## Other responses

- `400` — Invalid value extracted from request context, Invalid value for: body
- `500` — Internal Server Error

---

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