---
title: "Retrieve a single calculated metric by id"
method: GET
path: "/calculatedmetrics/{id}"
tags: ["calculatedmetrics"]
---

# Retrieve a single calculated metric by id

`GET /calculatedmetrics/{id}`

A calculated metric response will always include these default items: *id, name, description, rsid, owner, polarity, precision, type* 

Other attributes can be optionally requested through the 'expansion' field:

* *modified*: Date that the metric was last modified (ISO 8601)
* *definition*: Calculated metric definition as JSON object
* *compatibility*: Products that the metric is compatible with
* *reportSuiteName*: Also return the friendly Report Suite name for the RSID
* *tags*: Gives all existing tags associated with the calculated metric

For more information about calculated metrics go [here](https://github.com/AdobeDocs/analytics-2.0-apis/blob/master/calculatedmetrics.md)

## Path parameters

- `id` string, required

## Query parameters

- `locale` string
- `expansion` string[]

## Response `200`

successful operation

- AnalyticsCalculatedMetric
  - `id` string — System generated id
  - `name` string
  - `description` string
  - `rsid` string — The report suite id for which the component was created/updated
  - `reportSuiteName` string — The report suite name for which the component was created/updated
  - `owner` Owner
    - `id` integer, required — the login id of the owner
    - `name` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
    - `login` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
  - `polarity` 'positive' | 'negative' — Set metric polarity, which indicates whether it's good or bad if a given metric goes up. Default=positive
  - `precision` integer — Number of decimal places to include in calculated metric result
  - `type` 'CURRENCY' | 'TIME' | 'DECIMAL' | 'PERCENT'
  - `definition` CalculatedMetricDef, required
  - `categories` string[]
  - `tags` Tag[]
    - `id` integer — the tag id
    - `name` string — the tag name
    - `description` string — the tag description
    - `components` TaggedComponent[] — the list of components that have been tagged with this tag
      - `componentType` string
      - `componentId` string
      - `tags` Tag[]
  - `siteTitle` string
  - `modified` string, date-time
  - `created` string, date-time — Calculated metric creation date

## Other responses

- `403` — Requesting non-shared calculated metrics for other users is restricted to admin users
- `500` — External API error; calculated metric retrieval failed

## Changes

- **2022-05-10** `dcd4514630c4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/calculatedmetrics/:id/get.md)

---

[API](https://skmtc.dev/adobe/apis/adobe-analytics-apis.md) · [All operations](https://skmtc.dev/adobe/apis/adobe-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/adobe-analytics-apis/revisions/dcd4514630c4/schema)
