> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get statistics histogram > Obtenez des statistiques agrégées à des intervalles de temps précisés. Chaque intervalle contient les statistiques agrégées des e-mails envoyés durant cette période. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-marketing-emails-v2026-09.json GET /marketing/emails/2026-09/statistics/histogram openapi: 3.0.1 info: title: E-mails marketing description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Vous pouvez créer des e-mails marketing par programme, puis récupérer leurs statistiques d'envoi ultérieurement. x-hubspot-introduction: >- Utilisez l'API d'e-mail marketing pour créer, gérer et récupérer des détails concernant les e-mails marketing. Vous pouvez également utiliser cette API pour récupérer des statistiques concernant les envois d'e-mails, similaires à ce que vous pouvez voir dans HubSpot. servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Emails paths: /marketing/emails/2026-09/statistics/histogram: get: tags: - Basic summary: Obtenir des intervalles de statistiques agrégées description: >- Obtenez des statistiques agrégées à des intervalles de temps précisés. Chaque intervalle contient les statistiques agrégées des e-mails envoyés durant cette période. operationId: get-/marketing/emails/2026-09/statistics/histogram_getHistogram parameters: - name: emailIds in: query description: >- Une liste d'identifiants d'e-mails pour filtrer les statistiques. Il s'agit d'un paramètre de type formulaire qui peut inclure plusieurs identifiants. required: false style: form explode: true schema: type: array items: type: integer format: int64 - name: endTimestamp in: query description: >- L'horodatage de fin pour la plage de données statistiques. Doit être au format date-heure. required: false style: form explode: true schema: type: string format: date-time - name: interval in: query description: "L'intervalle de temps pour l'histogramme. Les valeurs valides sont\_: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, QUARTER_HOUR, MINUTE, et SECOND." required: false style: form explode: true schema: type: string enum: - DAY - HOUR - MINUTE - MONTH - QUARTER - QUARTER_HOUR - SECOND - WEEK - YEAR - name: startTimestamp in: query description: >- L'horodatage de début de la plage de données statistiques. Doit être au format date-heure. required: false style: form explode: true schema: type: string format: date-time responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponseWithTotalEmailStatisticInterval default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.email.read - oauth2: - marketing.email.write - oauth2: - content components: schemas: CollectionResponseWithTotalEmailStatisticInterval: required: - results - total type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: >- Un tableau d'objets EmailStatisticInterval, chacun représentant des statistiques pour un intervalle de temps spécifique. items: $ref: '#/components/schemas/EmailStatisticInterval' total: type: integer description: >- Un entier représentant le nombre total d'intervalles de statistiques d'e-mails disponibles. format: int32 Paging: type: object properties: next: $ref: '#/components/schemas/NextPage' prev: $ref: '#/components/schemas/PreviousPage' description: >- Représente les informations de pagination pour naviguer dans une liste de résultats de l'API. Il fournit des détails sur la manière d'accéder à l'ensemble de résultats précédent ou suivant. EmailStatisticInterval: required: - aggregations - interval type: object properties: aggregations: $ref: '#/components/schemas/EmailStatisticsData' interval: $ref: '#/components/schemas/Interval' Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base NextPage: required: - after type: object properties: after: type: string description: >- La valeur du jeton de curseur pour obtenir l'ensemble suivant de résultats. Utilisez cette valeur comme paramètre de requête (&after=...) afin d'obtenir la page suivante. link: type: string description: Le lien vers la page suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PreviousPage: required: - before type: object properties: before: type: string description: >- La valeur du jeton de curseur pour obtenir l'ensemble de résultats précédent. Utilisez cette valeur comme paramètre de requête (&before=...) afin d'obtenir la page précédente. link: type: string description: Le lien vers la page précédente. description: >- specifies the paging information needed to retrieve the previous set of results in a paginated API response EmailStatisticsData: required: - counters - deviceBreakdown - qualifierStats - ratios type: object properties: counters: type: object additionalProperties: type: integer format: int64 description: "Compteurs comme le nombre de «\_envoyés\_», «\_ouverts\_» ou «\_délivrés\_»." deviceBreakdown: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 description: Statistiques par appareil. qualifierStats: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 description: Nombre d'e-mails qui ont été annulés et rejetés. ratios: type: object additionalProperties: type: number description: "Ratios comme «\_openratio\_» ou «\_clickratio\_»" Interval: required: - end - start type: object properties: end: type: string description: "L'horodatage de fin de l'intervalle, au format\_ISO8601." format: date-time start: type: string description: "L'horodatage de début de l'intervalle, au format\_ISO8601." format: date-time ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: content: '' marketing-email: '' marketing.email.read: '' marketing.email.write: '' transactional-email: '' ````