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

# List Audiences

`POST /v1/audiences/list`

## Request

- Base URL: `https://api.monaco.com`
- URL: `https://api.monaco.com/v1/audiences/list`
- Auth: none declared

Returns a paginated list of audiences.

## Request body

- AudienceListRequest: Pagination for the audience list. The default page size covers every current org, so body-less calls keep returning all audiences in one page; filters and sort follow separately.
  - `page` integer: Page number (1-indexed)
  - `page_size` integer: Number of results per page

## Response `200`

Successful Response

- PublicListResponseAudienceResponse
  - `data` AudienceResponse[], required
    - `id` string, required: Unique identifier for the audience
    - `name` string, required: Name of the audience
    - `type` string, required: Audience type
    - `status` string, required: Audience status
    - `contact_count` integer, required: Number of contacts currently in the audience
    - `created_at` string, date-time, required: Date and time the audience was created
    - `updated_at` string, date-time, required: Date and time the audience was last updated
  - `pagination` PaginationInfo, required
    - `page` integer, required: Current page number
    - `page_size` integer, required: Number of results per page
    - `total_count` integer, required: Total number of matching records
    - `total_pages` integer, required: Total number of pages
  - `meta` ResponseMeta
    - `timestamp` string, date-time: Server timestamp of the response

## Other responses

- `4XX`: Client error

## Changes

- **2026-11-03** `fc720ada2a81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monaco/apis/monaco-public-api/changes/v1/audiences/list/post.md)

---

[API](https://skmtc.dev/monaco/apis/monaco-public-api.md) - [All operations](https://skmtc.dev/monaco/apis/monaco-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monaco/apis/monaco-public-api/revisions/fc720ada2a81?raw)