---
title: "Get aggregated customer metrics"
method: GET
path: "/customers/metrics"
tags: ["Customers"]
---

# Get aggregated customer metrics

`GET /customers/metrics`

Returns aggregated metrics for customers of the authenticated project.

## Query parameters

- `environment` 0 | 1
- `search` string
- `filter[status][]` string[]
- `filter[target_platform][]` string[]

## Response `200`

Customer metrics data.

- object — Aggregated customer metrics wrapped in the v4 envelope (object, url). Scalar counters reflect the current filter set (environment, status, platform, search).

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `403` — Insufficient permissions
- `429` — Too many requests
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)