List deliveries
Needs notification.manage
Newest first. q searches the hint, type, provider and message ID; filters (each repeatable): status, type, provider_kind (platform for the relay), provider (emp_…), test (test/live), plus created.
Query parameters
statusstring[]typestring[]provider_kindstring[]providerstring[]teststring[]limitintegerRows per page, 1 to 200.
Default50at least 1at most 200cursorstringqstringSearch: rows whose name (or the list's other searchable text) contains this, any case.
at most 200 charactersorderstringSort field; a leading
-sorts down. Each list names the fields it sorts by.at most 64 charactersmatches ^-?[a-z_]+$includestring[]total_count(counted up to 10,000) andfacets(a count per filter value).One oftotal_countfacetscreated_afterstringOnly rows created at or after this time (RFC 3339).
date-timecreated_beforestringOnly rows created at or before this time (RFC 3339).
date-timeupdated_afterstringOnly rows last changed at or after this time (RFC 3339).
date-timeupdated_beforestringOnly rows last changed at or before this time (RFC 3339).
date-time
Response200
objectstringlistdataEmailDelivery[]21 fields
idstringobjectstringemail_deliveryattemptsintegercreated_atstring or nullcustom_templatebooleandigest_countintegerduration_msinteger or nullerrorstring or nullfell_backbooleanlink_onlybooleanmessage_idstring or nullnotification_idstring or nullprovider_idstring or nullprovider_kindstringprovider_namestring or nullrecipient_hintstringstatusstringOne ofsentfailedsuppressedrate_limitedskippedtestbooleantypestringrecipientstring or nullsubjectstring or null
has_morebooleannext_cursorstring or nullfacetsmap<string, map<string, integer>> or nullpeoplemap<string, ActorRef> or null5 fields
idstring or nullkindstringOne ofuserapi_keyservice_accountworkloadend_usersystemnamestring or nullavatar_versionstring or nullemailstring or null
total_countinteger or nulltotal_count_exactboolean or null
Status codes
- 200Successful Response
- 422The request is not valid:
errors[]names each field. - 4XXThe request was refused: the problem says why.
- 5XXThe API could not answer: the problem says why.
curl "https://api.mydeepagents.com/v1/email_deliveries?limit=20" \
-H "Authorization: Bearer $MDA_API_KEY"JSON
{
"object": "list",
"data": [
{
"id": "eml_01jcekn5yqh6nhjfrf1q5xwth8",
"object": "email_delivery",
"attempts": 2,
"created_at": "2026-11-10T09:30:00.000Z",
"custom_template": true,
"digest_count": 2,
"duration_ms": 840,
"error": null,
"fell_back": true,
"link_only": true,
"message_id": "msg_01jc7qh04g97wt3q32g0wny446",
"notification_id": "ntf_01jcgbfa525gz2943pdr7ahcby",
"provider_id": "provider id",
"provider_kind": "provider kind",
"provider_name": "provider name",
"recipient": "recipient",
"recipient_hint": "recipient hint",
"status": "sent",
"subject": "subject",
"test": true,
"type": "type"
}
],
"has_more": false,
"next_cursor": null,
"total_count": 1
}