---
title: "Fetch Metric values for one or more systems"
method: POST
path: "/metrics/bulk"
tags: ["Metrics"]
---

# Fetch Metric values for one or more systems

`POST /metrics/bulk`

For each system ID passed, evaluates each metric ID/UUID passed for that system for the latest inspection data and returns the results. Instead of the latest inspection data, you can specify a date from which to retrieve metric values. Setting includeNonVisible true allows you to get metric values without requiring you to toggle metrics to display within the Liongard UI.

## Query parameters

- `includeNonVisible` boolean

## Request body

- object
  - `systems` integer[] — List of system IDs
  - `metrics` integer[] — List of metric IDs
  - `metricUUIDs` string[] — List of metric UUIDs
  - `date` string, date — Inspection date from which to retrieve metric values. If not specified, metric values from the latest inspection will be retrieved.

## Response `200`

Returns a JSON object. The top level key corresponds to the system ID. Within each system, each key corresponds to a metric evaluation object, which contains information about which timeline entry was returned and what the metric evaluated to.

- MetricEvaluation
  - `systemID` object — System ID that is passed in the query parameters
    - `metricID` object — Metric ID that is passed in the query parameters
      - `TimelineID` integer
      - `TimelineFinishedAt` string
      - `TimelineCreatedAt` string
      - `Metric` object
        - `ID` integer
        - `Name` string
        - `err` string, nullable
        - `value` union
          - string
          - number
          - integer
          - boolean
          - unknown[]
            - unknown
          - object

---

[API](https://skmtc.net/liongard/apis/liongard-v2-endpoints.md) · [All operations](https://skmtc.net/liongard/apis/liongard-v2-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liongard/liongard-v2-endpoints/versions/4ba1aeff82d7/schema)