---
title: "List the scheduled sends for the send calendar"
method: GET
path: "/api/projects/{project_id}/hog_flows/send_calendar/"
tags: ["hog_flows"]
---

# List the scheduled sends for the send calendar

`GET /api/projects/{project_id}/hog_flows/send_calendar/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/hog_flows/send_calendar/`
- Auth: HTTP bearer

Active batch and schedule workflows with an email step that is not transactional, and that have a schedule with sends to come or a batch run inside the range. Each carries only the fields a calendar card shows. Read a single workflow for its full configuration.

## Path parameters

- `project_id` string, required

## Query parameters

- `end` string, date-time, required
- `start` string, date-time, required

## Response `200`

- SendCalendarFlow[]
  - `id` string, uuid, required: ID of the workflow.
  - `name` string, nullable, required: Name of the workflow.
  - `origin_product` union, required: The product surface that owns the workflow, such as broadcasts. Null for a plain workflow. * `loops` - Loops * `broadcasts` - Broadcasts * `transactional_emails` - Transactional emails
    - 'loops' | 'broadcasts' | 'transactional_emails': * `loops` - Loops * `broadcasts` - Broadcasts * `transactional_emails` - Transactional emails
    - unknown
  - `created_by` UserBasic, required
    - `id` integer, required
    - `uuid` string, uuid, required
    - `distinct_id` string, nullable
    - `first_name` string
    - `last_name` string
    - `email` string, email, required
    - `is_email_verified` boolean, nullable
    - `hedgehog_config` object, nullable, required
    - `role_at_organization` union
      - 'engineering' | 'data' | 'product' | 'founder' | 'leadership' | 'marketing' | 'sales' | 'student' | 'other': * `engineering` - Engineering * `data` - Data * `product` - Product Management * `founder` - Founder * `leadership` - Leadership * `marketing` - Marketing * `sales` - Sales / Success * `student` - Student * `other` - Other
      - ''
      - unknown
  - `user_access_level` string, nullable, required: The reader's access level on the workflow.
  - `trigger_type` string, required: The trigger type: batch or schedule.
  - `audience_properties` object[], required: The property filters of a batch trigger's audience. Empty for a schedule trigger.
  - `audience_type` string, nullable, required: persons or accounts for a batch trigger's audience. Null when the trigger does not set it.
  - `email_to` string, nullable, required: The 'To' address of the first email step. A schedule trigger has no audience, so it sends here.
  - `message_category_id` string, nullable, required: ID of the message category of the first email step.
  - `schedules` HogFlowSchedule[], required: The schedules that still have sends to come.
    - `id` string, uuid, required
    - `rrule` string, required: iCalendar RRULE string (e.g. 'FREQ=DAILY;INTERVAL=1'). Must produce occurrences at most once per hour.
    - `starts_at` string, date-time, required: ISO 8601 datetime the schedule starts from.
    - `timezone` string: IANA timezone for interpreting the RRULE (default 'UTC').
    - `variables` unknown
    - `status` 'active' | 'paused' | 'completed', required: * `active` - Active * `paused` - Paused * `completed` - Completed
    - `next_run_at` string, date-time, nullable, required: Next scheduled fire time, computed by the scheduler.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `batch_jobs` SendCalendarBatchJob[], required: The batch runs that started inside the requested range.
    - `id` string, uuid, required: ID of the batch run.
    - `status` 'waiting' | 'queued' | 'active' | 'completed' | 'cancelled' | 'failed', required: * `waiting` - Waiting * `queued` - Queued * `active` - Active * `completed` - Completed * `cancelled` - Cancelled * `failed` - Failed
    - `created_at` string, date-time, required: When the batch run started.

## Changes

> 53 revisions in range; 1 not diffed.

- **2026-10-19** `9fafef801180`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/hog_flows/send_calendar/get.md)

---

[API](https://skmtc.dev/posthog/apis/posthog-api.md) · [All operations](https://skmtc.dev/posthog/apis/posthog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/posthog/apis/posthog-api/revisions/993f70ab941b?raw)