Get statistics with the Mailjet API

Returns sent, delivered, opened, clicked, bounced, spam and unsubscribed counts of a campaign, a list, a sender or the whole API key, over the lifetime or per 5 minutes, hour or day. The response has Data, Count and Total; page with Limit and Offset.

Identifier
mailjet_get_statistics

The request

POST https://connect.reportei.com/api/tools/mailjet_get_statistics/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "CounterSource": "Campaign",
    "CounterTiming": "Message",
    "CounterResolution": "Lifetime"
  }
}

Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.

Parameters

ParameterTypeRequiredDescription
CounterSourcestringYesWhat to count. List works only with CounterTiming Message and CounterResolution Lifetime, and Sender only with CounterTiming Message. APIKey covers the whole connected key.Values: Campaign, List, Sender, APIKey
CounterTimingstringYesMessage counts by the sending time of the emails, Event by the time of each open, click or other event. Event does not work with CounterResolution Lifetime.Values: Message, Event
CounterResolutionstringYesLifetime gives one total. Day, Hour and Highest, which is 5 minutes, give one row per period and need FromTS.Values: Lifetime, Day, Hour, Highest
SourceIDstringNoRequired unless CounterSource is APIKey. The CampaignID from List campaign drafts, the list ID from List contact lists or the sender ID from List senders. Several campaign or list IDs go separated by commas.
FromTSstringNoStart of the period, as an RFC3339 date-time or a Unix timestamp. Required unless CounterResolution is Lifetime. The period spans up to 100 periods of the resolution, so up to 100 days with Day.
ToTSstringNoEnd of the period, as an RFC3339 date-time or a Unix timestamp.
LimitintegerNoRows per page, up to 1000. The default is 10.
OffsetintegerNoIndex of the first row of the page. The default is 0.

Supported connections

Your customer connects their Mailjet account once, with one of the modes below. The same connection serves every tool of the toolkit.

Username and password

Your customer enters the app credentials on a Connect screen, or your system sends them with POST /api/customer-toolkits, with no screen.

The response

On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.

Ready for AI agents

This tool's input is a JSON Schema, available at GET /api/tools/mailjet_get_statistics. It becomes your agent's tool definition with no conversion.

Other Mailjet tools

See all 15 tools

Toolkits in the same category

See all 100 toolkits

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.