---
title: "Check Email Send Status"
method: POST
path: "/emailer_messages/email_send_status"
tags: ["Emailer Messages"]
---

# Check Email Send Status

`POST /emailer_messages/email_send_status`

Use the Check Email Send Status endpoint to check the current delivery status of an email message. This is typically used after calling the <a href="https://docs.apollo.io/reference/send-email-now" target="_blank">Send Email Now endpoint</a>, since emails are sent asynchronously and a successful send response only means the email was queued. <br><br>You must provide the `id` of the email message. The message must belong to your team, otherwise a `404` is returned. <br><br>The response always includes the message `id`, its current `status`, and a human-readable `message`. The remaining fields depend on the status: <ul> <li> If the email was delivered (`completed`), a `completed_at` timestamp is included. </li> <li> If the email failed (`failed`), a `not_sent_reason`, `failure_reason`, and `failed_at` timestamp may be included. </li> <li> If the email is still being processed (e.g. `drafted` or `scheduled`), a `retry_after_seconds` value is included to indicate how long to wait before checking again. </li> </ul>

## Request body

- object
  - `id` string, required — The Apollo ID of the email message to check. This is the `id` returned when you create an email draft or send an email. <br><br>Example: `66e8cc45028aed019c25d724`

## Response `200`

200

- object
  - `id` string
  - `status` string
  - `message` string
  - `completed_at` string, date-time
  - `not_sent_reason` string
  - `failure_reason` string
  - `failed_at` string, date-time
  - `retry_after_seconds` integer

## Other responses

- `401` — 401
- `404` — 404
- `422` — 422
- `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)