---
title: "Queries all audiences visible to the caller."
method: GET
path: "/audiences"
tags: ["Audience"]
---

# Queries all audiences visible to the caller.

`GET /audiences`

## Query parameters

- `page` integer
- `page_size` integer
- `sort` string[]
- `name` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `status` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `is_public` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `is_distilling` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `owner_mail` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `created_at` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `logic` 'and' | 'or'

## Response `200`

OK

- QueryAudiencesEndpointPagedResultOfOutput
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `items` QueryAudiencesEndpointOutput[], required
    - `id` string, required — The unique identifier of the audience.
    - `name` string, required — The name of the audience.
    - `description` string, nullable — The markdown-supported description of the audience.
    - `status` 'Created' | 'Pending' | 'Recruiting' | 'Ready', required
    - `qualifiedUserCount` integer, required — The number of users that have qualified for this audience.
    - `filters` IAudienceFilter[], required — The filters applied to this audience.
      - union
        - object
          - `_t` 'AndFilter', required
          - `filters` IAudienceFilter[], required
        - object
          - `_t` 'CountryFilter', required
          - `countries` string[], required
        - object
          - `_t` 'DemographicFilter', required
          - `identifier` string, required
          - `values` string[], required
        - object
          - `_t` 'DeviceFilter', required
          - `deviceTypes` DeviceType[], required
        - object
          - `_t` 'LanguageFilter', required
          - `languages` string[], required
        - object
          - `_t` 'NotFilter', required
          - `filter` IAudienceFilter, required — recursive
        - object
          - `_t` 'OrFilter', required
          - `filters` IAudienceFilter[], required
    - `logo` string, nullable — The URL of the audience logo, if any.
    - `createdAt` string, date-time, required — The timestamp when the audience was created.
    - `ownerMail` string, required — The email of the audience owner.
    - `organizationId` string, required — The id of the organization that owns the entity.
    - `isPublic` boolean, required — Whether the audience is publicly visible.
    - `isDistilling` boolean, required — Whether the audience is currently distilling users.
    - `graduationRule` union, required
      - object
        - `_t` 'AcceptedFreeText', required
        - `minAcceptedResponses` integer, required
        - `minAcceptedRatio` number, double, required
        - `demotionRatio` number, double, nullable
      - object
        - `_t` 'ScoreThreshold', required
        - `graduationScore` number, double, required
        - `demotionScore` number, double, nullable
        - `minResponsesToGraduate` integer, nullable
      - object
        - `_t` 'TaskAccuracy', required
        - `targetAccuracy` number, double, required
        - `minTasks` integer, required
        - `maxTasks` integer, nullable
    - `randomAdmissionProbability` number, double, nullable — The probability of admitting a random user to the audience.
    - `health` number, double, nullable — The health score of the audience.
    - `graduated` integer — The number of graduated users.
    - `dropped` integer — The number of dropped users.
  - `totalPages` integer

## Other responses

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

---

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