Check Email Send Status

No Credit Cost

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

Use the Check Email Send Status endpoint to check the current delivery status of an email message. This is typically used after calling the Send Email Now endpoint, since emails are sent asynchronously and a successful send response only means the email was queued.

You must provide the id of the email message. The message must belong to your team, otherwise a 404 is returned.

The response always includes the message id, its current status, and a human-readable message. The remaining fields depend on the status:

  • If the email was delivered (completed), a completed_at timestamp is included.
  • If the email failed (failed), a not_sent_reason, failure_reason, and failed_at timestamp may be included.
  • If the email is still being processed (like drafted or scheduled), a retry_after_seconds value is included to indicate how long to wait before checking again.

Body Params
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.

Example: 66e8cc45028aed019c25d724

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain