Get Email Delivery Status

Retrieve the delivery status of a sent email.

GET https://api.notifiedby.com/v1/email/delivery/<id>/

The email can be looked up by its ID in the URL path, or by using query parameters.

Query Parameters (alternative to path parameter):

Parameter	Required	Description
id	No	The email ID (same as the id returned when sending an email).

Note

You must provide the id in the URL path or as a query parameter.

Success Response (200):

{
    "id": "JDT",
    "status": "delivered",
    "ses_id": "0100018f5e1e9a1c-12345678-1234-1234-1234-123456789012-000000"
}

Field	Description
id	The email’s unique identifier.
status	Current delivery status (e.g., “delivered”, “bounced”, “pending”).
ses_id	Amazon SES message ID for the email.

Error Responses:

Email not found (404):

{
    "error": "Email not found"
}

No identifier provided (400):

{
    "detail": "Provide id in URL path, query parameter, or request payload."
}

Example Usage:

curl -H "Authorization: Api-Key YOUR_API_KEY" \
     https://api.notifiedby.com/v1/email/delivery/JDT/

import requests

response = requests.get(
    'https://api.notifiedby.com/v1/email/delivery/JDT/',
    headers={'Authorization': 'Api-Key YOUR_API_KEY'}
)

if response.status_code == 200:
    status = response.json()
    print(f"Email status: {status['status']}")

Status Values:

The status field can contain the following values:

• pending: Email is queued for delivery

• delivered: Email was successfully delivered

• bounced: Email bounced (permanent failure)

• complained: Recipient marked email as spam

• failed: Delivery failed for other reasons