---
title: "List Schedules"
method: GET
path: "/api/outreach/schedules"
tags: ["outreach", "outreach"]
---

# List Schedules

`GET /api/outreach/schedules`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/outreach/schedules`
- Auth: none declared

List all outreach schedules for the current user.

## Query parameters

- `status` string, nullable: Filter by status
- `person_id` integer, nullable: Filter by person
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ScheduleListResponse: List of outreach schedules.
  - `schedules` OutreachSchedule[], required
    - `id` integer, required
    - `target` ScheduleTarget, required: Target of a scheduled outreach.
      - `type` string, required
      - `id` integer, required
      - `name` string, required
      - `avatar_url` string, nullable
      - `channel` string, nullable
    - `name` string, required
    - `description` string, nullable
    - `message_type` string, required
    - `prompt_source` string, nullable
    - `prompt_id` integer, nullable
    - `prompt_state` string, nullable
    - `prompt_name` string, nullable
    - `llm_prompt` string, nullable
    - `llm_model` string, nullable
    - `template_text` string, nullable
    - `template_variables` object
    - `approval_mode` string, required
    - `schedule_type` string, required
    - `schedule_config` object
    - `next_run_at` string, nullable
    - `last_run_at` string, nullable
    - `last_run_status` string, nullable
    - `run_count` integer
    - `success_count` integer
    - `status` string, required
    - `end_date` string, nullable
    - `max_runs` integer, nullable
    - `preferred_channel` string, nullable
    - `attachment_file_ids` integer[]
    - `created_at` string, required
    - `updated_at` string, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)