# Get a scheduled send

Returns the details and delivery status of a specific scheduled email send.

## `GET /api/v1/mailboxes/{mailboxId}/scheduled/{scheduleId}`

### Path parameters

- `mailboxId` (string, required) — Mailbox ULID identifier
- `scheduleId` (string, required) — Scheduled send ULID identifier

### Responses

**200** — Scheduled send details

`application/json` → ScheduledSend

- `attempts` (integer, required) — Number of delivery attempts made
- `createdAt` (integer <int64>, required) — Creation timestamp in epoch seconds
- `deferrals` (integer, required) — Number of deferrals encountered
- `deliveryId` (string, required) — Idempotency key for this submission
- `error` (string | null, required) — Error reason if sending failed or was canceled, or null
- `finishedAt` (integer | null, required) — Completion timestamp in epoch seconds, or null if pending
- `messageId` (string, required) — Draft message ULID scheduled for sending
- `recipients` (string[], required) — List of target recipient email addresses
- `releaseAt` (integer <int64>, required) — Actual scheduled release time in epoch seconds
- `result` (array | null, required) — Per-recipient delivery outcomes, or null if pending
- `scheduleId` (string, required) — Scheduled send ULID
- `sendAt` (integer <int64>, required) — Requested send time in epoch seconds
- `state` ("pending" | "releasing" | "sent" | "failed" | "canceled", required) — Current scheduling status
- `threadId` (string | null, required) — Associated conversation thread ID, or null

**401** — unauthorized: the bearer credential is missing, malformed, expired, or revoked. Carries a `WWW-Authenticate: Bearer` challenge

`application/json` → ErrorBody

**404** — Mailbox or schedule not found

`application/json` → ErrorBody

**503** — temporary_failure: the platform's storage could not answer just now; retry after the Retry-After window. Any operation can answer this. A write that got it may have been applied, so retry it with the same idempotency key where it takes one, or read the state back first (see Transient failures in the API description)

`application/json` → ErrorBody

### Example request

```bash
curl -X GET 'https://api.open.email/api/v1/mailboxes/{mailboxId}/scheduled/{scheduleId}' \
  -H 'Authorization: Bearer oek_…'
```

## TypeScript SDK

[`openemail.scheduled.get`](/docs/sdks/typescript/scheduled/get)

```ts
const scheduledSend = await openemail.scheduled.get(mailboxId, scheduleId)
```
