---
title: "List Email Schedules"
method: GET
path: "/emailer_schedules"
tags: ["Sequences"]
---

# List Email Schedules

`GET /emailer_schedules`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/4409477927309-Configure-a-Sequence-Sending-Schedule" target="_blank">Sending schedules</a> control the days and times that Apollo sends emails for your sequences.<br><br>Use the List Email Schedules endpoint to retrieve every sending schedule that has been created for your team's Apollo account, including each schedule's ID, time zone, and weekly sending windows.<br><br>Use a schedule's `id` as the `emailer_schedule_id` when you <a href="https://docs.apollo.io/reference/create-sequence">create a sequence</a> or <a href="https://docs.apollo.io/reference/update-sequence">update a sequence</a> to control when that sequence's emails are sent.

## Response `200`

200

- object
  - `emailer_schedules` object[] — The list of sending schedules that belong to your team.
    - `id` string — The unique Apollo ID for the sending schedule. Use this value as the `emailer_schedule_id` when you create or update a sequence.
    - `name` string — The name of the sending schedule.
    - `default` boolean — Whether this is the default sending schedule for your team. Only one schedule can be the default at a time.
    - `time_zone` string — The IANA time zone that the schedule's sending windows are defined in, for example `America/Los_Angeles`.
    - `schedule_hash` object — The weekly sending windows, keyed by day of the week. Each day maps to an array of `[start_hour, end_hour]` pairs using 24-hour times, so `[[8, 17]]` means 8:00 AM to 5:00 PM. Days with no sending windows are omitted.
    - `created_at` string — The timestamp for when the schedule was created, in ISO 8601 format.
    - `use_contacts_time_zone` boolean — Whether Apollo sends emails according to each contact's own time zone instead of the schedule's `time_zone`.
    - `skip_holidays` boolean — Whether Apollo skips sending emails on holidays.

## Other responses

- `401` — 401
- `403` — 403
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)