---
title: "Returns the audience with the specified id."
method: GET
path: "/audience/{audienceId}"
tags: ["Audience"]
---

# Returns the audience with the specified id.

`GET /audience/{audienceId}`

Accepts the id of a filtered audience too. In that case the response describes the
 underlying base audience, with filter set to the filter applied on top of it.

## Path parameters

- `audienceId` string, required

## Response `200`

OK

- GetAudienceByIdEndpointOutput
  - `id` string, required — The unique identifier of the audience.
  - `baseAudienceId` string, required — The audience that backs this entry. Equals id for a regular audience; for a filtered audience it points to the audience the filter is applied on top of.
  - `filter` 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
  - `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.
  - `ownerId` string, uuid, required — The unique identifier of the audience owner.
  - `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.
  - `distillingCampaignId` string, required — The id of the distilling campaign associated with the audience.
  - `minGraduatedForDistillingBoost` integer, nullable — Minimum graduated users before disabling distilling boost.
  - `minDistillingForGlobalBoost` integer, nullable — Minimum distilling users before disabling global boost.
  - `graduationRule` union, required
    - 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
  - `maxDistillingResponses` integer, nullable — Maximum responses before user exits the distilling campaign.
  - `dropMinResponses` integer, nullable — Minimum responses before the drop score check applies.
  - `dropScore` number, double, nullable — Score floor - users below this score exit the distilling campaign.
  - `maxDistillingSessions` integer, nullable — Maximum sessions before user exits the distilling campaign.
  - `inactivityDropDays` integer, nullable — Number of days of inactivity before a distilling user is dropped.
  - `minSubmissionRate` number, double, nullable — Minimum submission rate before a user is dropped.
  - `minSessionsForSubmissionRate` integer, nullable — Minimum number of sessions before the submission rate check applies.
  - `minSubmissionRateGraduated` number, double, nullable — Minimum submission rate for graduated users.
  - `distillingRetrievalMode` 'Random' | 'Shuffled' | 'Sequential', required
  - `boostLevel` 'None' | 'Stable' | 'Distilling' | 'Global', required
  - `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.

## 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/e42ec51c7b88/schema)