---
title: "fetch list of audiences"
method: GET
path: "/api/servicepool/audiences"
tags: ["audiences"]
---

# fetch list of audiences

`GET /api/servicepool/audiences`

## Query parameters

- `filter` ParametersFilter
  - `where` ParametersFilterWhere
  - `fields` ParametersFilterFields
  - `limit` number
  - `skip` number
  - `order` string[]
  - `collate` ParametersFilterCollation
    - `locale` string
    - `strength` number
    - `caseLevel` boolean
    - `numericOrdering` boolean

## Response `200`

list of `audience`

- object
  - `data` AudienceDto[], required
    - `activeCampaignCount` number — The number of active audience campaigns
    - `archivedAt` string, date-time — The date and time the audience was archived
    - `archivedBy` string — The unique identifier of the user who archived the audience
    - `audienceCampaignCount` number — The number of audience campaigns
    - `clickRate` number — The click rate of the audience as a fractional percentage (e.g. 0.2365 for 23.65%)
    - `clicked` number — The number of clicked messages
    - `companyUuid` string, required — The unique identifier of the company
    - `createdAt` string, date-time, required — The date and time the audience was created
    - `createdBy` string, required — The unique identifier of the user who created the audience
    - `deletedAt` string, date-time — The date and time the audience was deleted
    - `deletedBy` string — The unique identifier of the user who deleted the audience
    - `delivered` number — The number of delivered messages
    - `description` string — The description of the audience
    - `filterValues` string — The filter values of the audience
    - `filters` string — The filters of the audience
    - `name` string, required — The name of the audience
    - `openRate` number — The open rate of the audience as a fractional percentage (e.g. 0.2365 for 23.65%)
    - `opened` number — The number of opened messages
    - `pipeline` string — The pipeline of the audience
    - `proximity` object, nullable
      - `distance` number, required — The numeric distance from location
      - `unit` 'mile' | 'kilometer', required — The unit of measurement
      - `locationUuid` string, required — The unique identifier of the location to check distance against
    - `sent` number — The number of sent messages
    - `status` 'active' | 'archived' | 'deleted' — The status of the audience
    - `talentCount` number — The number of talents in the audience
    - `updatedAt` string, date-time, required — The date and time the audience was updated
    - `updatedBy` string, required — The unique identifier of the user who updated the audience
    - `uuid` string, required — The unique identifier of the audience
    - `vectors` object, nullable
      - `jobMatch` object, nullable
        - `matchThreshold` number, required — The match threshold of the job match vector
        - `matchType` 'Job' | 'Opening', required — The match type of the job match vector
        - `matchUuid` string, required — The unique identifier of the job match vector
    - `version` number — The version of the audience
    - `isHidden` boolean — Whether the audience is hidden or not

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)