---
title: "List all automation flows across jobs"
method: GET
path: "/api/v1/automation/flows"
tags: ["Automation::Flows"]
---

# List all automation flows across jobs

`GET /api/v1/automation/flows`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/automation/flows`
- Auth: HTTP bearer

## Query parameters

- `q` string
- `job_post_id` integer
- `active` boolean
- `state` string
- `sort_by` string
- `page` integer
- `page_size` integer

## Response `200`

OK with pagination

- object
  - `data` AutomationFlow[], required
    - `id` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `name` string, required
    - `description` string, nullable, required
    - `trigger_event` 'manual' | 'application_created' | 'application_updated' | 'talent_profile_updated' | 'interview_scheduled' | 'application_shortlisted', required
    - `purpose` 'outreach' | 'transactional', required
    - `trigger_config` TriggerConfig, required
      - `allow_retrigger` boolean, nullable
      - `conditions` ConditionStepConfig, nullable
        - `field` string, nullable
        - `operator` string, nullable
        - `value` unknown
        - `and` ConditionStepConfig[], nullable
        - `or` ConditionStepConfig[], nullable
    - `stop_config` StopConfig, required
      - `conditions` ConditionStepConfig, nullable
        - `field` string, nullable
        - `operator` string, nullable
        - `value` unknown
        - `and` ConditionStepConfig[], nullable
        - `or` ConditionStepConfig[], nullable
    - `active` boolean, required
    - `executions_count` integer, required
    - `running_count` integer, required
    - `running_count_version` string, required
    - `missing_channels` string[], required
    - `unknown_channels` string[], required
    - `outreach_config` object, nullable, required
      - `channels` object, required
        - `email` boolean, required
        - `whatsapp` boolean, required
        - `ai_call` boolean, required
      - `duration` 'one_day' | 'three_days' | 'one_week' | 'two_weeks', required
      - `work_emails` boolean, required
      - `follow_up_task` boolean, required
      - `audience` object, required
        - `kind` 'all' | 'score_range', required
        - `min` number
        - `max` number
      - `subjects` object, required
        - `intro` string
        - `follow_up` string
        - `closing` string
      - `name` string, nullable
    - `editable` boolean, required
    - `agent_state` 'active' | 'manual' | 'needs_setup' | 'paused', required
    - `agent_issues` object[], required
    - `candidates_count` integer, required
    - `contacted_count` integer, required
    - `replied_count` integer, required
    - `flow_steps` AutomationFlowStep[], required
      - `id` integer, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `step_id` string, required
      - `step_type` 'condition' | 'action' | 'wait', required
      - `role` 'flow' | 'on_stop', required
      - `is_first_step` boolean, required
      - `transition_config` object, required
        - `next` string, nullable
        - `true` string, nullable
        - `false` string, nullable
      - `display_name` string
      - `step_config` union, required
        - WaitStepConfig
          - `duration` string, nullable
          - `anchor` string, nullable
          - `offset` object, nullable
            - `value` number
            - `unit` string
            - `direction` string
        - ActionStepConfig
          - `type` 'reveal_contact' | 'send_email' | 'send_whatsapp_message' | 'ai_call' | 'add_tag' | 'create_task', required
          - `outreach_template_id` string, nullable
          - `agent_id` string, nullable
          - `wait` WaitStepConfig
            - `duration` string, nullable
            - `anchor` string, nullable
            - `offset` object, nullable
              - …
          - `title` string, nullable
          - `task_type` string, nullable
          - `halt_until_completed` boolean, nullable
          - `assignee_ids` integer[], nullable
          - `due_in_days` integer, nullable
          - `email_template_id` integer, nullable
          - `tag_names` string[], nullable
          - `template_name` string, nullable
          - `subject_text` string, nullable
          - `allow_business_emails` boolean, nullable
          - `whatsapp_kind` 'chatbot' | 'template', nullable: send_whatsapp_message only. chatbot starts outreach_chatbot_id; template (or absent) sends the outreach template. Ignored while the WhatsApp chatbot feature is off.
          - `outreach_chatbot_id` string, nullable: Outreach chatbot id, stored exactly as outreach returns it (it names one version)
        - ConditionStepConfig, nullable
          - `field` string, nullable
          - `operator` string, nullable
          - `value` unknown
          - `and` ConditionStepConfig[], nullable
          - `or` ConditionStepConfig[], nullable
    - `job_post` object
      - `id` integer, required
      - `title` string, required
      - `company_name` string, required
    - `reply_rate` object, required
      - `value` number, required
      - `numerator` integer, required
      - `denominator` integer, required
    - `completion_rate` object, required
      - `value` number, required
      - `numerator` integer, required
      - `denominator` integer, required
    - `failed_count` integer, required
    - `last_executed_at` string, nullable, required
  - `meta` PaginationMeta, nullable
    - `total_count` integer
    - `total_pages` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `current_page` integer
    - `page_size` integer

## Other responses

- `401`: Authentication failed

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)