List Emails

List emails that have been sent. Results are paginated and ordered by most recent first.

GET https://api.notifiedby.com/v1/email/list/

Query Parameters:

Parameter	Required	Description
recipient	No	Filter by recipient email address.
page	No	Page number for pagination (default: 1).

Success Response (200):

{
    "count": 42,
    "next": "https://api.notifiedby.com/v1/email/list/?page=2",
    "previous": null,
    "results": [
        {
            "recipient": "user@example.com",
            "subject": "Welcome!",
            "created_on": "2026-02-17T12:00:00Z"
        }
    ]
}

Field	Description
count	Total number of emails matching the query.
next	URL for the next page, or null if on the last page.
previous	URL for the previous page, or null if on the first page.
results	Array of email summary objects.

Each email object in results contains:

Field	Description
recipient	The recipient’s email address.
subject	The email subject line.
created_on	Timestamp when the email was sent.

Error Response (400):

If the recipient parameter is not a valid email address:

{"recipient": "Enter a valid email address."}

Example with curl:

curl -X GET "https://api.notifiedby.com/v1/email/list/?recipient=user@example.com&page=1" \
    -H "Authorization: Api-Key YOUR_API_KEY"