---
title: "Get Reports Metadata"
method: GET
path: "/network-reporting/v1/reports-meta"
tags: ["Reporting"]
---

# Get Reports Metadata

`GET /network-reporting/v1/reports-meta`

This API endpoint allows users to retrieve reports metadata such as list of kpis, filters applicable for report types. This information is required when creating reports.

## Query parameters

- `type` string
- `kpi-widget` string

## Response `200`

Get Reports Metadata Response

- ReportsMetadata
  - `id` string, required — Unique identifier for the reports metadata resource.
  - `type` string, required — Resource type identifier.
  - `generation` integer, required — Monotonically increasing update counter.
  - `createdAt` string, date-time, required — Timestamp when the resource was created (RFC 3339 UTC).
  - `updatedAt` string, date-time, required — Timestamp when the resource was last updated (RFC 3339 UTC).
  - `kpiWidgets` KPIWidget[]
    - `kpiWidget` string, required
    - `displayName` string
    - `description` string
    - `reportName` string
    - `reportType` string
    - `reportCategory` string
    - `kpi` string
    - `kpiDisplayName` string
    - `kpiDescription` string
    - `allowedRenderTypes` string[], required
    - `isTimeSliceEnabled` boolean
    - `columns` Columns[]
      - `column` string
      - `displayName` string
      - `optionality` 'OPTIONAL' | 'OPTIONAL_PRESELECTED' | 'MANDATORY'
    - `filters` FilterMeta[]
      - `filter` string
      - `displayName` string
      - `description` string
      - `validations` ReportValidation[]
        - `type` string
        - `values` string[]
        - `description` string

## Other responses

- `400` — Invalid input received.
- `401` — Unauthorized. Authentication credentials are required or invalid.
- `403` — Forbidden: Access is denied.
- `404` — Not Found error.
- `429` — Too Many Requests. The user has sent too many requests in a given amount of time.
- `500` — Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.dev/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.dev/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)