Passer au contenu principal
GET
/
marketing
/
v3
/
emails
/
statistics
/
list
Obtenir des statistiques agrégées
curl --request GET \
  --url https://api.hubapi.com/marketing/v3/emails/statistics/list \
  --header 'Authorization: Bearer <token>'
{
  "aggregate": {
    "counters": {},
    "deviceBreakdown": {},
    "qualifierStats": {},
    "ratios": {}
  },
  "campaignAggregations": {},
  "emails": [
    123
  ]
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de requête

emailIds
integer<int64>[]

Filtrez par ID d'e-mail. Inclut seulement les statistiques des e-mails ayant ces ID.

endTimestamp
string

L'horodatage de la fin de la période, au format ISO8601.

property
string

Précise les propriétés d'e-mail à afficher. Toutes les propriétés seront affichées par défaut.

startTimestamp
string

L'horodatage du début de la période, au format ISO8601.

Réponse

successful operation

Aggregated statistics for the given interval, plus the IDs of emails that were sent during that interval.

aggregate
object
campaignAggregations
object

Les statistiques agrégées par campagne.

emails
integer<int64>[]

Liste des identifiants e-mail qui ont été envoyés au cours de la période.

Last modified on December 8, 2025