V3 REFERENCE Statistics

/senderstatistics

API Key sender email address message/open/click statistical information.

List senderstatistics resources available for this apikey, use a GET request. Alternatively, you may want to add one or more filters.

# list senderstatistics resources

curl -s -X GET \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
https://api.mailjet.com/v3/REST/senderstatistics
Unique Key

In addition to the resource $ID, you can also use the unique key $Email to identify this resource. Please refer to the field(s) description below for more information.

Properties
Name Description
BlockedCount Number of blocked messages.
  • Read Only
  • [ Type Integer ]
BouncedCount Number of bounced messages.
  • Read Only
  • [ Type Integer ]
ClickedCount Number of registered clicks.
  • Read Only
  • [ Type Integer ]
DeferredCount
  • New for accounts created after March, 15th, 2018.
Number of deferred messages.
  • Read Only
  • [ Type Integer ]
DeliveredCount Number of messages delivered to their destination.
  • Read Only
  • [ Type Integer ]
HardbouncedCount
  • New for accounts created after March, 15th, 2018.
Number of hardbounced messages.
  • Read Only
  • [ Type Integer ]
LastActivityAt Timestamp of last registered activity for this sender.
  • Read Only
  • [ Type RFC3339 DateTime ]
OpenedCount Number of message open registrations.
  • Read Only
  • [ Type Integer ]
ProcessedCount Total number of messages processed by Mailjet.
  • Read Only
  • [ Type Integer ]
SenderID Reference to the sender for which the statistics are collected.
  • Read Only
  • [ Type Integer ]
SoftbouncedCount
  • New for accounts created after March, 15th, 2018.
Number of softbounced messages.
  • Read Only
  • [ Type Integer ]
QueuedCount Number of messages awaiting in send queue.
  • Read Only
  • [ Type Integer ]
SpamComplaintCount Number of spam complaints.
  • Read Only
  • [ Type Integer ]
UnsubscribedCount Number of registered unsubscribed requests.
  • Read Only
  • [ Type Integer ]
WorkFlowExitedCount
  • New for accounts created after March, 15th, 2018.
Number of messages with an automation exit event.
  • Read Only
  • [ Type Integer ]
Filters
Name Description
Domain Only retrieve sender statistics for which the sender email address domain matches the specified value.
  • [ Type String ]
Email Only retrieve senders statistics for which the sender email address' local part matches the specified value.
  • [ Type String ]
Sender Only retrieve senderstatistics resources for which Sender equals the specified value.
  • [ Type Integer ]

Access a given senderstatistics resource, use a GET request, providing the senderstatistics's ID value.

# access the senderstatistics resource identified by $ID

curl -s -X GET \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
https://api.mailjet.com/v3/REST/senderstatistics/$ID

    
# access the resource through the Email's value
# note: all keys marked as 'unique' may be used as an alternate ID

curl -s -X GET \
--user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
https://api.mailjet.com/v3/REST/senderstatistics/$Email
    
    
Unique Key

In addition to the resource $ID, you can also use the unique key $Email to identify this resource. Please refer to the field(s) description below for more information.

Properties
Name Description
BlockedCount Number of blocked messages.
  • Read Only
  • [ Type Integer ]
BouncedCount Number of bounced messages.
  • Read Only
  • [ Type Integer ]
ClickedCount Number of registered clicks.
  • Read Only
  • [ Type Integer ]
DeferredCount
  • New for accounts created after March, 15th, 2018.
Number of deferred messages.
  • Read Only
  • [ Type Integer ]
DeliveredCount Number of messages delivered to their destination.
  • Read Only
  • [ Type Integer ]
HardbouncedCount
  • New for accounts created after March, 15th, 2018.
Number of hardbounced messages.
  • Read Only
  • [ Type Integer ]
LastActivityAt Timestamp of last registered activity for this sender.
  • Read Only
  • [ Type RFC3339 DateTime ]
OpenedCount Number of message open registrations.
  • Read Only
  • [ Type Integer ]
ProcessedCount Total number of messages processed by Mailjet.
  • Read Only
  • [ Type Integer ]
SenderID Reference to the sender for which the statistics are collected.
  • Read Only
  • [ Type Integer ]
SoftbouncedCount
  • New for accounts created after March, 15th, 2018.
Number of softbounced messages.
  • Read Only
  • [ Type Integer ]
QueuedCount Number of messages awaiting in send queue.
  • Read Only
  • [ Type Integer ]
SpamComplaintCount Number of spam complaints.
  • Read Only
  • [ Type Integer ]
UnsubscribedCount Number of registered unsubscribed requests.
  • Read Only
  • [ Type Integer ]
WorkFlowExitedCount
  • New for accounts created after March, 15th, 2018.
Number of messages with an automation exit event.
  • Read Only
  • [ Type Integer ]