REST API

Mail logs

Paginated delivery rows for the authenticated user.

GET/api/v1/mail-logs

List mail logs

Paginated delivery rows. Query: page (default 1), page_size (default 20, max 100), campaign_id, account_id, campaign_run_id, status (pending | sending | sent | failed | deferred).

Authentication: Authorization: Bearer with your Mailofly API key

Query parameters

Field	Type	Description
page	number	Page index, default 1.
page_size	number	Page size, default 20, max 100.
campaign_id	uuid?	Filter by campaign.
account_id	uuid?	Filter by sending account.
campaign_run_id	uuid?	Filter by run.
status	string?	pending \| sending \| sent \| failed \| deferred

Returns

Field	Type	Description
data	MailLogRow[]	Rows with optional joined campaign_title, account_name, …
page	number	Current page.
page_size	number	Page size.
total	number	Total matching rows.

cURL

curl -sS -X GET "https://www.mailofly.com/api/v1/mail-logs?page=1&page_size=20&status=sent" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer mf_live_your_key_here"

Requests use https://www.mailofly.com

API key

Response

Try it sends the request through this app to https://www.mailofly.com (no browser CORS issues).

Click Try it to run the example against the live API.

Example responses

{
  "data": [],
  "page": 1,
  "page_size": 20,
  "total": 0
}

GET/api/v1/mail-logs