---
title: "Creates a filtered view on the given base audience by applying a filter on top of its
 graduates. Returns an audience id that can be used in job creation just like a regular
 audience id; no new onboarding is required."
method: POST
path: "/audience/{baseAudienceId}/filter"
tags: ["Audience"]
---

# Creates a filtered view on the given base audience by applying a filter on top of its
 graduates. Returns an audience id that can be used in job creation just like a regular
 audience id; no new onboarding is required.

`POST /audience/{baseAudienceId}/filter`

## Path parameters

- `baseAudienceId` string, required

## Request body

- CreateFilteredAudienceEndpointInput
  - `filter` union, required
    - 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

## Response `200`

OK

- CreateFilteredAudienceEndpointOutput
  - `audienceId` string, required — The unique identifier of the filtered audience. Use this id in job creation.

## Other responses

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

---

[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/4ee3e6f5e4f4/schema)
