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

# Fetch Metric values for one or more systems

`GET /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. You can use this to build your own reports. You must pass a list of system IDs and metric IDs/UUIDs in the URL parameters. You can request values for up to 10 systems at a time.  Setting includeNonVisible true allows you to get metric values without requiring you to toggle metrics to display within the Liongard UI.

## Query parameters

- `systems` integer[], required
- `metrics` integer[]
- `uuids` string[], required
- `includeNonVisible` boolean

## 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)
