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

# Fetch Campaigns

> Retrieves a list of campaigns associated with a specified organisation. This includes campaigns' names, subjects, statuses, creation dates, and email tracking settings.

### Path Parameters

- `organisation_id` (`int`): The ID of the organisation for which campaigns are being fetched.

### Headers

- `X-API-Key`: API key for user authentication. Ensures that the request is made by an authorised user.

### Response

- Returns a list of `Campaign` objects, each encapsulating details about a specific email campaign, including its ID, name, subject, creation date, status (e.g., pending, active, completed), and whether email tracking is enabled.

### Errors

- `403 Forbidden`: If the authenticated user is not a member of the specified organisation.
- `404 Not Found`: The campaign does not belong to the specified organisation.



## OpenAPI

````yaml GET /api/v1/campaigns
openapi: 3.1.0
info:
  title: ChaseLabs API
  version: 0.1.0
servers:
  - url: https://services.meetchase.ai
security: []
paths:
  /api/v1/campaigns:
    get:
      tags:
        - Public API Routes
        - Campaign Routes
      summary: Fetch Campaigns Api
      description: >-
        Retrieves a list of campaigns associated with a specified organisation.
        This includes campaigns' names, subjects, statuses, creation dates, and
        email tracking settings.


        ### Path Parameters


        - `organisation_id` (`int`): The ID of the organisation for which
        campaigns are being fetched.


        ### Headers


        - `X-API-Key`: API key for user authentication. Ensures that the request
        is made by an authorised user.


        ### Response


        - Returns a list of `Campaign` objects, each encapsulating details about
        a specific email campaign, including its ID, name, subject, creation
        date, status (e.g., pending, active, completed), and whether email
        tracking is enabled.


        ### Errors


        - `403 Forbidden`: If the authenticated user is not a member of the
        specified organisation.

        - `404 Not Found`: The campaign does not belong to the specified
        organisation.
      operationId: fetch_campaigns_api_api_v1_campaigns_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/CampaignExternal'
                type: array
                title: Response Fetch Campaigns Api Api V1 Campaigns Get
      security:
        - API Key: []
components:
  schemas:
    CampaignExternal:
      properties:
        name:
          type: string
          maxLength: 63
          minLength: 1
          title: Name
        unsubscribe_mode:
          type: string
          enum:
            - 'off'
            - one-click
            - text
          title: Unsubscribe Mode
          default: one-click
        meeting_duration:
          type: integer
          exclusiveMaximum: 256
          exclusiveMinimum: 0
          title: Meeting Duration
        test_mode:
          type: boolean
          title: Test Mode
        id:
          type: integer
          title: Id
        status:
          type: string
          title: Status
        email_tracking:
          type: boolean
          title: Email Tracking
        link_tracking:
          type: boolean
          title: Link Tracking
        include_disclaimer:
          type: boolean
          title: Include Disclaimer
        auto_pilot_settings:
          $ref: '#/components/schemas/AutoPilotSettings'
        auto_enrich:
          type: boolean
          title: Auto Enrich
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - name
        - meeting_duration
        - test_mode
        - id
        - status
        - email_tracking
        - link_tracking
        - include_disclaimer
        - auto_pilot_settings
        - created_at
      title: CampaignExternal
      examples:
        - auto_enrich: false
          auto_pilot_settings:
            cancel_meeting: false
            create_meeting: false
            do_not_contact: true
            do_not_respond: false
            move_meeting: false
            put_on_hold: true
            send_email: false
            send_reconnect_email: false
            send_referral_email: false
            unsuccessful_delivery: true
          created_at: '2023-11-05 17:26:49.244856'
          email_tracking: false
          id: 1
          include_disclaimer: true
          link_tracking: false
          meeting_duration: 30
          name: Lead Generation Campaign
          status: PENDING
          test_mode: false
          unsubscribe_mode: one-click
    AutoPilotSettings:
      properties:
        cancel_meeting:
          type: boolean
          title: Cancel Meeting
          description: >-
            If True, the AI automatically handles meeting cancellations. If
            False, these events are flagged for human review.
          default: false
        create_meeting:
          type: boolean
          title: Create Meeting
          description: >-
            If True, the AI automatically schedules new meetings. If False,
            proposed meetings require manual confirmation.
          default: false
        do_not_contact:
          type: boolean
          title: Do Not Contact
          description: >-
            If True, the AI automatically processes 'do not contact' or opt-out
            requests. If False, these critical requests are flagged for a human
            to process.
          default: true
        do_not_respond:
          type: boolean
          title: Do Not Respond
          description: >-
            If True, the AI automatically archives emails that do not require a
            response (e.g., 'Thanks!'). If False, a human will review these
            emails first.
          default: false
        move_meeting:
          type: boolean
          title: Move Meeting
          description: >-
            If True, the AI automatically handles requests to reschedule a
            meeting. If False, rescheduling requests are flagged for human
            review.
          default: false
        put_on_hold:
          type: boolean
          title: Put On Hold
          description: >-
            If True, the AI automatically schedules a reconnect action after
            receiving an Out of Office (OOO) reply. If False, OOO replies are
            flagged for manual review.
          default: true
        send_email:
          type: boolean
          title: Send Email
          description: >-
            If True, the AI is permitted to send standard email replies. If
            False, all draft replies must be approved by a human first.
          default: false
        send_reconnect_email:
          type: boolean
          title: Send Reconnect Email
          description: >-
            If True, the AI automatically sends follow-up or 'reconnect' emails
            according to the campaign schedule. If False, reconnect emails are
            flagged for review.
          default: false
        send_referral_email:
          type: boolean
          title: Send Referral Email
          description: >-
            If True, the AI automatically engages with new contacts who have
            been referred. If False, referral engagements are sent to a human
            for review.
          default: false
        unsuccessful_delivery:
          type: boolean
          title: Unsuccessful Delivery
          description: >-
            If True, the AI automatically processes bounce-back notifications
            from unsuccessful deliveries. If False, these notifications are
            flagged for manual review.
          default: true
      type: object
      title: AutoPilotSettings
      description: >-
        Manages the automation settings for a campaign's AI assistant.


        Each setting determines whether the AI should handle a specific event

        automatically (`True`) or flag it for manual human review (`False`).
        Think of

        these as permissions for the AI to act on its own.
      examples:
        - cancel_meeting: false
          create_meeting: false
          do_not_contact: true
          do_not_respond: false
          move_meeting: false
          put_on_hold: true
          send_email: false
          send_reconnect_email: false
          send_referral_email: false
          unsuccessful_delivery: true
  securitySchemes:
    API Key:
      type: apiKey
      description: Key used to authenticate user API requests.
      in: header
      name: X-API-Key

````