---
title: "List scheduled sends"
method: GET
path: "/mailboxes/{address}/scheduled"
tags: ["Drafts"]
---

# List scheduled sends

`GET /mailboxes/{address}/scheduled`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/mailboxes/{address}/scheduled`
- Auth: HTTP bearer

Sends waiting for their time, plus the last seven days' finished ones with how they ended: `sent`, `cancelled`, or `failed` with a `reason`. Each one points at its draft by `uid`. Requires scope `mail:read`.

## Path parameters

- `address` string, required

## Response `200`

Scheduled sends, soonest first

- object
  - `success` boolean
  - `data` ScheduledSendList
    - `scheduled` ScheduledSend[]
      - `id` string: Use it to cancel the send
      - `uid` integer: The draft that will be sent, in the Drafts folder
      - `sendAt` string, date-time
      - `status` 'scheduled' | 'sending' | 'retrying' | 'sent' | 'cancelled' | 'failed'
      - `reason` string: Why it was cancelled or failed
      - `messageId` string: Message-ID of the sent email, once sent
      - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `404`: Resource not found
- `429`: Rate limit exceeded

---

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