---
title: "Segment distribution across all dimensions"
method: GET
path: "/{teamPid}/analytics/audience"
tags: ["Analytics"]
---

# Segment distribution across all dimensions

`GET /{teamPid}/analytics/audience`

## Request

- Base URL: `https://api.rightmessage.com/v1`
- URL: `https://api.rightmessage.com/v1/{teamPid}/analytics/audience`
- Auth: HTTP bearer

Requires an API token with the `read` or `write` ability. Tokens created without abilities have `*`, which grants every ability.

## Path parameters

- `teamPid` string, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required
- `timezone` string

## Response `200`

- object
  - `data` union, required
    - object
      - `segmentCounts` object, required
    - object
      - `segmentCounts` unknown[], required
        - unknown
    - object
      - `segmentCounts` string[], required
      - `goalTracking` union, required
        - object
          - `status` 'after_next_publish', required
          - `from` string, required
          - `explanation` 'Conversions start recording after your next publish.' | 'This goal is paused, so its conversions are not recorded.' | 'Attach this goal to a campaign to start measuring conversions.' | 'null', nullable, required
        - object
          - `status` 'recorded', required
          - `from` string, required
          - `explanation` 'Conversions start recording after your next publish.' | 'This goal is paused, so its conversions are not recorded.' | 'Attach this goal to a campaign to start measuring conversions.' | 'null', nullable, required
        - object
          - `status` 'paused', required
          - `from` string, required
          - `explanation` 'Conversions start recording after your next publish.' | 'This goal is paused, so its conversions are not recorded.' | 'Attach this goal to a campaign to start measuring conversions.' | 'null', nullable, required
        - object
          - `status` 'not_attached', required
          - `from` string, required
          - `explanation` 'Conversions start recording after your next publish.' | 'This goal is paused, so its conversions are not recorded.' | 'Attach this goal to a campaign to start measuring conversions.' | 'null', nullable, required

## Other responses

- `401`: Missing, invalid or revoked API token.
- `404`: Not found
- `422`: Validation error
- `429`: Rate limit exceeded: 120 requests per minute for project endpoints, 60 per minute for token and connection endpoints. Retry after the `Retry-After` seconds.

---

[API](https://skmtc.dev/rightmessage/apis/rightmessage-api.md) - [All operations](https://skmtc.dev/rightmessage/apis/rightmessage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rightmessage/apis/rightmessage-api/revisions/adec35e9720c?raw)