---
title: "Get a metrics search."
method: GET
path: "/v1/metricsSearches/{id}"
tags: ["metricsSearchesManagement"]
---

# Get a metrics search.

`GET /v1/metricsSearches/{id}`

Returns a metrics search with the specified identifier.

## Path parameters

- `id` string, required

## Response `200`

A metrics search object with metadata.

- MetricsSearchInstance — Definition of a metrics search.
  - `title` string, required — Item title in the content library.
  - `description` string, required — Item description in the content library.
  - `timeRange` ResolvableTimeRange, required
    - `type` string, required — Type of the time range. Value must be either `CompleteLiteralTimeRange` or `BeginBoundedTimeRange`.
  - `logQuery` string — Log query used to add an overlay to the chart.
  - `metricsQueries` MetricsSearchQuery[], required — Metrics queries, up to the maximum of six.
    - `rowId` string, required — Row identifier. All row IDs are represented by subsequent upper case letters starting with `A`.
    - `query` string, required — Metrics query.
  - `desiredQuantizationInSecs` integer — Desired quantization in seconds.
  - `properties` string — Chart properties, like line width, color palette, and the fill missing data method. Leave this field empty to use the defaults. This property contains JSON object encoded as a string.
  - `createdAt` string, date-time, required — Creation timestamp in UTC in [RFC3339](https://tools.ietf.org/html/rfc3339) format.
  - `createdBy` string, required — Identifier of the user who created the resource.
  - `modifiedAt` string, date-time, required — Last modification timestamp in UTC.
  - `modifiedBy` string, required — Identifier of the user who last modified the resource.
  - `id` string, required — Identifier of the metrics search.
  - `parentId` string — Identifier of the parent element in the content library, such as folder.

## Other responses

- `default` — Operation failed with an error.

---

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