List scheduled deliveries
const url = 'https://mail.work.optidata.cloud/api/mail/mailboxes/78/scheduled';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://mail.work.optidata.cloud/api/mail/mailboxes/78/scheduled \ --header 'Authorization: Bearer <token>'Every delivery still in play for the mailbox — those waiting, those being sent right now, and those that failed — ordered by delivery time.
Requires scheduled sending to be enabled for the tenant.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Id of the mailbox. Every mailbox the caller may use is listed in their account.
Responses
Section titled “ Responses ”The active scheduled deliveries.
A draft waiting for its delivery time.
object
When the message will be sent.
The time zone the user chose the moment in.
Where a scheduled delivery stands.
How many delivery attempts have been made.
Why the last attempt failed, when one did.
Examples
[ { "id": 44, "draft_id": 918, "mailbox_id": 78, "scheduled_at": "2026-08-20T09:00:00.000000Z", "timezone": "America/Sao_Paulo", "status": "pending", "sent_at": null, "attempts": 0, "last_error": null, "created_at": "2026-08-19T13:10:00.000000Z", "updated_at": "2026-08-19T13:10:00.000000Z" }]Missing, malformed or expired authentication key.
Authentication failures use an error key rather than message.
object
Examples
No bearer token sent
{ "error": "JWT passport exception: Missing bearer token in request"}Scheduled sending is not enabled for this tenant.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "Not available"}Rate limit exceeded. Retry after the window resets.
Generic error envelope used by policy, binding and framework failures.
object
Human-readable description of the failure.
Examples
{ "message": "Too Many Attempts."}