> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsailer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List campaign participants

> Who is in this campaign, and where each of them is in it.

`projected_send_at` is an estimate: blast windows, conversation conflicts and retries all move it.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/campaigns/{campaign_id}/participants
openapi: 3.1.0
info:
  description: >-
    The Sailer REST API for CRM, conversations, and campaigns.


    **Authentication.** Send a scoped token as `Authorization: Bearer
    sk_live_...`.

    Tokens are workspace-scoped; the workspace is implied by the token, so no

    tenant header is needed. A workspace administrator creates and revokes them;

    the secret is shown once at creation and cannot be recovered afterwards.


    **Pagination.** Collections return `{data, meta, links}`. Follow
    `links.next`

    until it is `null`; treat the cursor as opaque.


    **Errors.** Every non-2xx response is `{"error": {...}}` with a stable
    `code`.

    Quote `error.request_id` when contacting support.


    **Custom fields.** Workspace-defined fields appear under `custom_fields`,
    keyed

    by `field_key`. Read a record to see which keys a workspace uses; a
    dedicated

    field-discovery endpoint is not part of this release.
  title: Sailer API
  version: 1.0.0
servers:
  - url: https://api.chatsailer.com
security:
  - SailerApiToken: []
tags:
  - description: Token introspection and workspace capabilities.
    name: Meta
  - description: >-
      People you talk to. Called *leads* in older Sailer surfaces; `contact` is
      the current name.
    name: Contacts
  - description: Companies that contacts belong to (B2B accounts).
    name: Organizations
  - description: Opportunities moving through a pipeline.
    name: Deals
  - description: Pipelines and their stages.
    name: Pipelines
  - description: Field definitions, including custom fields.
    name: Fields
  - description: Free-text annotations on CRM records.
    name: Notes
  - description: Scheduled and logged CRM activities.
    name: Activities
  - description: Per-entity label catalogs.
    name: Tags
  - description: Message threads with contacts, across every channel.
    name: Conversations
  - description: Outbound campaigns and their participants.
    name: Campaigns
paths:
  /v1/campaigns/{campaign_id}/participants:
    get:
      tags:
        - Campaigns
      summary: List campaign participants
      description: >-
        Who is in this campaign, and where each of them is in it.


        `projected_send_at` is an estimate: blast windows, conversation
        conflicts and retries all move it.
      operationId: list_campaign_participants
      parameters:
        - in: path
          name: campaign_id
          required: true
          schema:
            description: Unique identifier for a campaign.
            examples:
              - camp_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4
            pattern: ^camp_[0-9a-f]{32}$
            title: Campaign Id
            type: string
        - description: Items per page (max 200).
          in: query
          name: limit
          required: false
          schema:
            default: 50
            description: Items per page (max 200).
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
        - description: Opaque cursor from a previous response's `links.next`.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Opaque cursor from a previous response's `links.next`.
            title: Cursor
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignParticipantList'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - SailerApiToken: []
components:
  schemas:
    CampaignParticipantList:
      description: A page of campaign participants.
      properties:
        data:
          items:
            $ref: '#/components/schemas/CampaignParticipant'
          title: Data
          type: array
        links:
          $ref: '#/components/schemas/PageLinks'
        meta:
          $ref: '#/components/schemas/PageMeta'
      required:
        - data
        - meta
        - links
      title: CampaignParticipantList
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    CampaignParticipant:
      description: One contact's place in a campaign.
      properties:
        campaign_id:
          description: Unique identifier for a campaign.
          examples:
            - camp_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4
          pattern: ^camp_[0-9a-f]{32}$
          title: Campaign Id
          type: string
        contact_id:
          description: Unique identifier for a contact.
          examples:
            - con_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4
          pattern: ^con_[0-9a-f]{32}$
          title: Contact Id
          type: string
        contacted_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: When this contact was actually messaged.
          title: Contacted At
        created_at:
          format: date-time
          title: Created At
          type: string
        id:
          description: Unique identifier for a campaign participant.
          examples:
            - cpar_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4
          pattern: ^cpar_[0-9a-f]{32}$
          title: Id
          type: string
        object:
          const: campaign_participant
          default: campaign_participant
          title: Object
          type: string
        projected_send_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: >-
            When the campaign's schedule expects to message them. An estimate,
            not a commitment — blast windows and conflicts move it.
          title: Projected Send At
        status:
          $ref: '#/components/schemas/CampaignParticipantStatus'
        updated_at:
          format: date-time
          title: Updated At
          type: string
      required:
        - id
        - campaign_id
        - contact_id
        - status
        - created_at
        - updated_at
      title: CampaignParticipant
      type: object
    PageLinks:
      properties:
        next:
          anyOf:
            - type: string
            - type: 'null'
          description: Opaque cursor for the following page; null on the last page.
          title: Next
      title: PageLinks
      type: object
    PageMeta:
      properties:
        has_more:
          description: True when a next page exists.
          title: Has More
          type: boolean
        limit:
          description: Maximum items requested for this page.
          title: Limit
          type: integer
      required:
        - limit
        - has_more
      title: PageMeta
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    CampaignParticipantStatus:
      enum:
        - pending
        - queued
        - processing
        - on_hold
        - conflict
        - sent
        - failed
        - cancelled
        - answered
        - excluded
      title: CampaignParticipantStatus
      type: string
  securitySchemes:
    SailerApiToken:
      description: >-
        A workspace API token. Create one in Settings → API. Send it as
        `Authorization: Bearer sk_live_...`.
      scheme: bearer
      type: http

````