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

# List Campaigns

> List all outbound calling campaigns in your Famulor account via API. View status, lead counts, assigned AI voice agents and progress metrics.

This endpoint allows you to list all campaigns.

### Response Fields

The API returns a direct array of campaigns:

<ResponseField name="array" type="array">
  Array of all campaigns

  <Expandable title="Campaign Properties">
    <ResponseField name="id" type="integer">
      The ID of the campaign
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the campaign
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the campaign
    </ResponseField>

    <ResponseField name="max_calls_in_parallel" type="integer">
      Maximum number of calls that can be made in parallel
    </ResponseField>

    <ResponseField name="mark_complete_when_no_leads" type="boolean">
      Whether the campaign should be marked as complete when no leads are available
    </ResponseField>

    <ResponseField name="allowed_hours_start_time" type="string">
      The start time for allowed calling hours
    </ResponseField>

    <ResponseField name="allowed_hours_end_time" type="string">
      The end time for allowed calling hours
    </ResponseField>

    <ResponseField name="allowed_days" type="array">
      The weekdays on which calls are allowed
    </ResponseField>

    <ResponseField name="max_retries" type="integer">
      Maximum number of retry attempts for failed calls
    </ResponseField>

    <ResponseField name="retry_interval" type="integer">
      Interval in seconds between retry attempts
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp when the campaign was created
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp when the campaign was last updated
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "New Customer Acquisition Q1 2024",
      "status": "active",
      "max_calls_in_parallel": 5,
      "mark_complete_when_no_leads": true,
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "18:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_retries": 3,
      "retry_interval": 300,
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-15T14:30:00Z"
    }
  ]
  ```
</ResponseExample>

<Tip>
  Related pages: [Introduction](/en/api-reference/introduction) and [Authentication Guide](/en/developers/authentication-guide), and [API Integration Examples](/en/developers/api-integration-examples).
</Tip>
