---
title: "List audiences"
method: GET
path: "/v1/audiences"
tags: ["Audiences"]
---

# List audiences

`GET /v1/audiences`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/audiences`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/audiences/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Get all audiences created in the account. To create an audience, use [Create audience](https://docs.talon.one/integration-api#tag/Audiences/operation/createAudienceV2).

## Query parameters

- `pageSize` integer
- `skip` integer
- `sort` string
- `withTotalResultSize` boolean

## Response `200`

OK

- object
  - `hasMore` boolean
  - `totalResultSize` integer
  - `data` Audience[], required
    - `accountId` integer, required: The ID of the account that owns this entity.
    - `id` integer, required: The internal ID of this entity.
    - `created` string, date-time, required: The time this entity was created.
    - `name` string, required: The human-friendly display name for this audience.
    - `sandbox` boolean: Indicates if this is a live or sandbox Application.
    - `description` string: A description of the audience.
    - `subscribedApplicationsIds` integer[]: A list of the IDs of the Applications that are connected to this audience.
    - `integration` string: The Talon.One-supported [3rd-party platform](https://docs.talon.one/docs/dev/technology-partners/overview) that this audience was created in. For example, `mParticle`, `Segment`, `Shopify`, `Braze`, or `Iterable`. **Note:** If you do not integrate with any of these platforms, do not use this property.
    - `integrationId` string: The ID of this audience in the third-party integration. **Note:** To create an audience that doesn't come from a 3rd party platform, do not use this property.
    - `createdIn3rdParty` boolean: Determines if this audience is a 3rd party audience or not.
    - `lastUpdate` string, date-time: The last time that the audience memberships changed.

---

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