---
title: "Gets the count of users in each state for the specified audience."
method: GET
path: "/audience/{audienceId}/user-metrics"
tags: ["Audience"]
---

# Gets the count of users in each state for the specified audience.

`GET /audience/{audienceId}/user-metrics`

## Path parameters

- `audienceId` string, required

## Response `200`

OK

- GetAudienceUserStateMetricsResult
  - `usersPerState` object, required
  - `capacity` 'None' | 'Low' | 'Sufficient' | 'null', nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

## Changes

- **2026-09-04** `9da534659e5f` — 2 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
  - added the required property `capacity` to the response with the `200` status

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/audience/:audienceId/user-metrics/get.md)

---

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