List scheduled emails

GET/api/v1/mailbox/messages/scheduled
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Emails waiting to be sent at a set time, soonest first.

Errors

Status When
401 No token, or the session expired or was signed out. Sign in again with POST /mailbox-auth/login.
403 The account has a temporary password: until POST /security/password succeeds, every other call answers this with error_code: password_change_required.

Request

GET/api/v1/mailbox/messages/scheduled
curl -X GET 'https://courier.mailyte.com/api/v1/mailbox/messages/scheduled' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'

Response

Successful Response

  • dataobject
    • messagesarray<object>
      • idstring
      • folderstring
      • send_atstring or null
      • statusstring

        pending, sending or failed (a failed send is retried).

      • attemptsinteger
      • errorstring or null
      • created_atstring or null
200application/json
{
  "type": "success",
  "msg": "Scheduled messages",
  "data": {
    "messages": [
      {
        "id": "Scheduled:7",
        "folder": "Scheduled",
        "send_at": "2026-10-12T08:00:00+00:00",
        "status": "pending",
        "attempts": 0,
        "error": null,
        "created_at": "2026-10-11T16:20:00+00:00"
      }
    ]
  }
}

Returned inside the standard envelope.

Errors

StatusWhen
401No token, or the session expired or was signed out. Sign in again with `POST /mailbox-auth/login`.
403The account has a temporary password: until `POST /security/password` succeeds, every other call answers this with `error_code: password_change_required`.

Every status, with what causes it and what to do, is on the error reference.