Skip to content

Latest commit

 

History

History
53 lines (44 loc) · 4.67 KB

File metadata and controls

53 lines (44 loc) · 4.67 KB

MailLogEntry

A single email record in the mail log. Combines data from the message store (envelope metadata), the queue release table (delivery status and response), and the sender delivery table (MX routing details). Key field relationships with other API calls: - The id field matches the mailid query parameter on GET /mail/log and the text field of a successful send response. - The from address can be passed to POST /mail/blocks/delete to delist a flagged sender. - The user field is the SMTP username (e.g. mb5658) corresponding to the username field in GET /mail / GET /mail/{id}.

Properties

Name Type Description Notes
id int Internal auto-increment database row ID. Not meaningful outside the API.
id str The relay-assigned mail ID (18–19 hex characters). This is the value returned as `text` by the sending endpoints and accepted as the `mailid` filter on `GET /mail/log`.
var_from str SMTP envelope `MAIL FROM` address (may differ from the `From:` header).
to str SMTP envelope `RCPT TO` address.
subject str The `Subject` header value, if available. [optional]
message_id str The `Message-ID` header value, if present. Can be used with the `messageId` filter on `GET /mail/log` for subsequent lookups. [optional]
created str Human-readable creation timestamp in `YYYY-MM-DD HH:MM:SS` format.
time int Unix timestamp of message acceptance. Corresponds to the `startDate` and `endDate` filter parameters on `GET /mail/log`.
user str The SMTP AUTH username used to submit the message (e.g. `mb5658`). Corresponds to the `username` field in `GET /mail` orders.
transtype str SMTP transaction type negotiated with the relay (e.g. `ESMTPSA`).
origin str IP address of the client that submitted the message to the relay. Corresponds to the `origin` filter parameter on `GET /mail/log`.
interface str Relay interface name that accepted the message (e.g. `feeder`).
sending_zone str The sending zone assigned by the relay for outbound delivery. [optional]
body_size int Size of the message body in bytes. [optional]
seq int Sequence index of this recipient in a multi-recipient message. Starts at 1. [optional]
delivered int Delivery status flag. `1` = successfully delivered to destination MX. `0` = queued, deferred, or failed. `null` = delivery not yet attempted. Corresponds to the `delivered` filter parameter on `GET /mail/log`. [optional]
response str The SMTP response string received from the destination MX server upon delivery attempt (e.g. `"250 2.0.0 Ok queued as C91D83E128C"`). [optional]
recipient str The specific recipient address this delivery record is for. [optional]
domain str The destination domain. Corresponds to the `mx` filter parameter (which matches `mxHostname`, not `domain`) on `GET /mail/log`. [optional]
locked int Whether the queue entry is currently locked for delivery processing. [optional]
lock_time str Millisecond-precision timestamp of the last queue lock acquisition. [optional]
assigned str The relay server node assigned to deliver this message. [optional]
queued str ISO 8601 timestamp when the message was placed into the delivery queue. [optional]
mx_hostname str The MX hostname the relay connected to for delivery. Corresponds to the `mx` filter parameter on `GET /mail/log`. [optional]

Example

from openapi_client.models.mail_log_entry import MailLogEntry

# TODO update the JSON string below
json = "{}"
# create an instance of MailLogEntry from a JSON string
mail_log_entry_instance = MailLogEntry.from_json(json)
# print the JSON string representation of the object
print(MailLogEntry.to_json())

# convert the object into a dict
mail_log_entry_dict = mail_log_entry_instance.to_dict()
# create an instance of MailLogEntry from a dict
mail_log_entry_from_dict = MailLogEntry.from_dict(mail_log_entry_dict)

[Back to Model list] [Back to API list] [Back to README]