---
title: "List subscription metrics by subscription numbers"
method: GET
path: "/v1/subscriptions/subscription-metrics"
tags: ["Subscriptions"]
---

# List subscription metrics by subscription numbers

`GET /v1/subscriptions/subscription-metrics`

Lists subscription metrics for the subscriptions that you specify by subscription numbers.

## Query parameters

- `asOfDay` string
- `subscriptionNumbers[]` string[], required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GETMetricsBySubscriptionNumbersResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.
  - `subscriptionMetrics` object[]
    - `subscriptionNumber` string — The number for the subscription.
    - `contractedMrr` number — Monthly recurring revenue of the subscription.
    - `contractedNetMrr` number — Monthly recurring revenue of the subscription rate plan inclusive of all the discounts applicable, including the fixed-amount discounts and percentage discounts.
    - `asOfDayGrossMrr` number — Monthly recurring revenue of the subscription rate plan exclusive of any discounts applicable as of specified day.
    - `asOfDayNetMrr` number — Monthly recurring revenue of the subscription rate plan inclusive of all the discounts applicable, including the fixed-amount discounts and percentage discounts as of specified day.
    - `netTotalContractedValue` number — Total contracted value of the subscription inclusive of all the discounts applicable, including the fixed-amount discounts and percentage discounts.
    - `totalContractedValue` number — Total contracted value of the subscription.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)