---
title: "List Campaigns"
method: POST
path: "/v1/campaigns/list"
tags: ["Campaigns"]
---

# List Campaigns

`POST /v1/campaigns/list`

## Request

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

Returns a paginated list of campaigns.

## Request body

- PublicListRequest
  - `filters` union: Filters to apply. Accepts either a flat list of filter rules, implicitly ANDed together, or a recursive filter expression with 'operator' and 'filters'. When an expression omits 'operator', it defaults to 'and'. The flat form must be a JSON array — a single rule sent as a bare object is not a valid filter. Filter field names, their valid operators, and allowed values come from GET /v1/schemas/{entity} — each field lists 'allowed_operators' and 'enum_field_settings.allowed_values'; field names differ per entity, so the examples on each list endpoint show fields valid for that entity. Custom fields are keyed 'custom_field_<uuid>'; related-entity custom fields use '<relation>.custom_field_<uuid>' and are filter-only.
    - FilterRule[]
      - `field` string, required
      - `condition` string, required
      - `value` unknown
    - FilterExpression: A filter expression with an explicit operator. Contains filters that can be either FilterRule objects (leaf nodes) or nested FilterExpression objects (branch nodes), allowing for arbitrarily nested filter structures.
      - `operator` 'and' | 'or': Logical operators to combine filters or filter expressions.
      - `filters` union[]
        - union
          - FilterRule
            - `field` string, required
            - `condition` string, required
            - `value` unknown
          - FilterExpression (recursive)
  - `page` integer: Page number (1-indexed)
  - `page_size` integer: Number of results per page
  - `sort` string: Field to sort by. Prefix with '-' for descending order.

## Response `200`

Successful Response

- PublicListResponseCampaignResponse
  - `data` CampaignResponse[], required
    - `id` string, required: Unique identifier for the campaign
    - `name` string, required: Name of the campaign
    - `status` 'active' | 'paused' | 'completed' | 'draft' | 'archived', required: Lifecycle status of a campaign.
    - `prioritized` boolean, required: Whether this campaign takes priority over non-prioritized campaigns
    - `end_date` string, date, nullable: Date the campaign stops enrolling
    - `template_id` string, required: ID of the template enrolled contacts are placed on
    - `template_name` string, nullable: Title of the template
    - `audiences` CampaignAudienceRef[]: Audiences enrolled in this campaign
      - `id` string, required: Unique identifier for the audience
      - `name` string, required: Name of the audience
    - `enrollment_status` 'pending' | 'running' | 'enriching' | 'completed' | 'failed', required: Progress of the async audience-enrollment task behind create/update. ``enriching``: the sequences exist and are listed, but their contacts' emails are still being found and verified. Edits are rejected until it completes.
    - `created_at` string, date-time, required: Date and time the campaign was created
    - `updated_at` string, date-time, required: Date and time the campaign 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/campaigns/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)