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

# List campaign targets

> List campaign targets.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/platforms/{platform}/campaigns/{campaignId}/targets
openapi: 3.1.0
info:
  title: Optareach Public API
  version: 1.0.0
  description: >-
    Platform-first API surface for accounts, prospects, campaigns, inbox,
    tracked searches, AI rooms, workspaces, analytics, billing, profile, and
    knowledge bases.
servers:
  - url: https://optareach.com
    description: Production
security: []
tags:
  - name: Meta
    description: API metadata and discovery
  - name: Platforms
    description: Platform registry and capabilities
  - name: Accounts
    description: Connected sender accounts
  - name: Prospects
    description: Prospect lists and leads
  - name: Campaigns
    description: Campaign lifecycle and performance
  - name: Inbox
    description: Conversations and messages
  - name: TrackedSearches
    description: Mentions and tracked search streams
  - name: AI
    description: AI chat rooms and enrichment
  - name: Workspaces
    description: Workspace management
  - name: KnowledgeBases
    description: Knowledge base management
  - name: Analytics
    description: Global dashboard metrics
  - name: Billing
    description: Subscriptions and credits
  - name: Profile
    description: Current user profile
  - name: Tags
    description: Conversation tags
paths:
  /api/v1/platforms/{platform}/campaigns/{campaignId}/targets:
    get:
      tags:
        - Campaigns
      summary: List campaign targets
      description: List campaign targets.
      parameters:
        - $ref: '#/components/parameters/platform'
        - $ref: '#/components/parameters/campaignId'
        - $ref: '#/components/parameters/campaignTargetLimit'
        - $ref: '#/components/parameters/campaignTargetCursor'
      responses:
        '200':
          description: Targets
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/CampaignTarget'
                      nextCursor:
                        type:
                          - string
                          - 'null'
                      total:
                        type: integer
                    required:
                      - items
                required:
                  - data
              examples:
                success:
                  summary: Example response
                  value:
                    data:
                      items:
                        - leadId: lead_jane_doe
                          fullName: Jane Doe
                          company: Acme
                          status: contacted
                      nextCursor: null
                      total: 1
components:
  parameters:
    platform:
      name: platform
      in: path
      required: true
      schema:
        type: string
    campaignId:
      name: campaignId
      in: path
      required: true
      schema:
        type: string
    campaignTargetLimit:
      name: limit
      in: query
      required: false
      description: Maximum contacted targets to return. Defaults to 100; maximum 100.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 100
    campaignTargetCursor:
      name: cursor
      in: query
      required: false
      description: Opaque cursor returned by the preceding campaign-target page.
      schema:
        type: string
  schemas:
    CampaignTarget:
      type: object
      properties:
        leadId:
          type: string
        fullName:
          type: string
        company:
          type: string
        status:
          type: string
      required:
        - leadId
        - fullName
        - status

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.