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

# List campaign texts

> One row per initial outbound campaign text message, including the customer's first reply. Designed for partners ingesting Avoca outbound activity into a BI warehouse. Always scoped to the team in the URL path. Requires the `read:outbound` permission.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/teams/{teamId}/outbound/campaign-texts
openapi: 3.1.0
info:
  title: Avoca Enterprise API
  description: >-
    Read-only programmatic access to Avoca data: calls and recordings,
    transcripts, leads, coach evaluations, Simple Scheduler sessions and
    analytics, outbound texting activity, and enterprise support tickets.
  version: 1.4.0
servers:
  - url: https://enterprise-api.avoca.ai
security:
  - bearerAuth: []
tags:
  - name: Calls
    description: Call records, recordings, transcripts, and pre-call transfers
  - name: Leads
    description: Unified leads (v0) and the canonical leads feed (v1)
  - name: Teams
    description: Teams accessible to the API key
  - name: Coach
    description: Coach (QA) call evaluations and rubrics
  - name: Scheduler Analytics (v0)
    description: Simple Scheduler analytics — legacy flat endpoints
  - name: Sessions & Bookings
    description: v1 scheduling-widget sessions and completed bookings
  - name: Analytics (v1)
    description: v1 funnel, UTM, service-area, and issue-type analytics
  - name: Outbound Texting
    description: Campaign text and subscription-event feeds for BI ingestion
  - name: Support Tickets
    description: Customer-safe enterprise support-ticket feed
paths:
  /api/v1/teams/{teamId}/outbound/campaign-texts:
    get:
      tags:
        - Outbound Texting
      summary: List campaign texts
      description: >-
        One row per initial outbound campaign text message, including the
        customer's first reply. Designed for partners ingesting Avoca outbound
        activity into a BI warehouse. Always scoped to the team in the URL path.
        Requires the `read:outbound` permission.
      operationId: listCampaignTexts
      parameters:
        - $ref: '#/components/parameters/teamIdPath'
        - name: campaign_name
          in: query
          required: true
          description: Campaign to return texts for
          schema:
            type: string
        - $ref: '#/components/parameters/startDate'
        - $ref: '#/components/parameters/endDate'
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit500default50'
      responses:
        '200':
          description: Paginated campaign texts
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CampaignText'
                  pagination:
                    $ref: '#/components/schemas/CursorPagination'
                  meta:
                    type: object
                    properties:
                      team_id:
                        type: integer
                      campaign_name:
                        type: string
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  parameters:
    teamIdPath:
      name: teamId
      in: path
      required: true
      description: The team ID
      schema:
        type: integer
    startDate:
      name: start_date
      in: query
      description: Only rows on/after this ISO 8601 timestamp
      schema:
        type: string
        format: date-time
    endDate:
      name: end_date
      in: query
      description: Only rows before this ISO 8601 timestamp
      schema:
        type: string
        format: date-time
    cursor:
      name: cursor
      in: query
      description: >-
        Opaque pagination cursor from the previous response's
        `pagination.cursor`
      schema:
        type: string
    limit500default50:
      name: limit
      in: query
      description: Results per page (default 50, max 500)
      schema:
        type: integer
        default: 50
        maximum: 500
  schemas:
    CampaignText:
      type: object
      properties:
        action:
          type: string
          enum:
            - outbound_message
          description: Constant `outbound_message` — this feed is outbound-only
        customer_id:
          type:
            - string
            - 'null'
          description: Conversation's resolved CRM customer ID
        campaign_name:
          type: string
        customer_response:
          type: string
          description: Body of the customer's first inbound reply, else `no response`
        created_date:
          type: string
          format: date-time
        phone_number:
          type: string
        category:
          type: string
          enum:
            - ai_handled
            - human_handled
            - resolved
        is_booked:
          type: boolean
        is_waiting_for_us:
          type: boolean
        is_waiting_for_customer:
          type: boolean
        customer_responded:
          type: boolean
        campaign_type:
          type:
            - string
            - 'null'
          description: >-
            Campaign workflow type, such as `SPEED_TO_LEAD`, `RESCHEDULE`, or
            `MAINTENANCE`
        messages:
          type: array
          description: Full chronological conversation thread
          items:
            $ref: '#/components/schemas/CampaignTextMessage'
      required:
        - action
        - customer_id
        - campaign_name
        - customer_response
        - created_date
        - phone_number
        - category
        - is_booked
        - is_waiting_for_us
        - is_waiting_for_customer
        - customer_responded
        - campaign_type
        - messages
    CursorPagination:
      type: object
      properties:
        cursor:
          type:
            - string
            - 'null'
          description: >-
            Pass back as the `cursor` query parameter to fetch the next page;
            `null` on the last page
        has_more:
          type: boolean
        limit:
          type: integer
    CampaignTextMessage:
      type: object
      properties:
        direction:
          type: string
          enum:
            - INCOMING
            - OUTGOING
        sender:
          type: string
          enum:
            - customer
            - ai
            - human
        body:
          type:
            - string
            - 'null'
          description: Message text; null for media-only messages
        created_at:
          type: string
          format: date-time
        media_urls:
          type: array
          items: {}
        tool_results:
          description: Structured tool-call results, or null when absent
      required:
        - direction
        - sender
        - body
        - created_at
        - media_urls
        - tool_results
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error type
        message:
          type: string
          description: Human-readable description (newer endpoints)
      required:
        - error
  responses:
    Forbidden:
      description: API key lacks the required permission or team access
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key in the format `avoca_<64 hex characters>`

````