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

# Get Metric Records Data

`POST /beta/analytics/records`

Get data of specific metric records (unaggregated)

## Query parameters

- `pageLimit` integer
- `pageKey` string

## Request body

- union
  - GetMetricRecordsDataInputCsidFilter
    - `id` string, required
    - `csidFilter` integer[]
    - `filters` Filter[]
      - `attribute` string, required
      - `values` string[]
    - `timezone` string, required
  - GetMetricRecordsDataInputPeriodFilter
    - `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[]
    - `timezone` string, required

## Response `200`

The metric records data

- GetMetricRecordsDataOutput
  - `data` MetricRecord[]
    - `primaryTimestampField` TimestampField, required
      - `name` string, required
      - `timestamp` string, date-time, required
    - `value` union
      - BooleanField
        - `value` boolean, required
      - DoubleField
        - `value` number, double, required
      - InstantField
        - `value` string, date-time, required
      - IntField
        - `value` integer, required
      - ListField
        - `values` PrimitiveField[]
          - union
            - BooleanField
              - …
            - DoubleField
              - …
            - InstantField
              - …
            - IntField
              - …
            - LongField
              - …
            - StringField
              - …
            - UUIDField
              - …
      - LongField
        - `value` integer, required
      - StringField
        - `value` string, required
        - `label` string
      - TimestampField
        - `name` string, required
        - `timestamp` string, date-time, required
      - UUIDField
        - `value` string, uuid, required
        - `label` string
    - `fields` Field[]
      - `name` string, required
      - `field` union
        - BooleanField
          - `value` boolean, required
        - DoubleField
          - `value` number, double, required
        - InstantField
          - `value` string, date-time, required
        - IntField
          - `value` integer, required
        - ListField
          - `values` PrimitiveField[]
            - union
              - …
        - LongField
          - `value` integer, required
        - StringField
          - `value` string, required
          - `label` string
        - TimestampField
          - `name` string, required
          - `timestamp` string, date-time, required
        - UUIDField
          - `value` string, uuid, required
          - `label` string
  - `meta` PaginationLinks
    - `previous` string — url
    - `next` string — url

## Other responses

- `400` — Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey, 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)