> ## 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. # Retrieve participant breakdown by external ID > Lisez la répartition des participations à l'événement marketing avec des filtres optionnels par paire externalAccountId et externalEventId. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/legacy/v3/marketing-marketing-events-v3.json GET /marketing/v3/marketing-events/participations/{externalAccountId}/{externalEventId}/breakdown openapi: 3.0.1 info: title: Marketing Marketing Events description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Marketing Events Guide url: >- https://developers.hubspot.com/docs/guides/api/marketing/marketing-events servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Event Attendees - name: Event Status - name: Identifiers - name: List Associations - name: Participant State - name: Settings - name: Subscriber State Changes paths: /marketing/v3/marketing-events/participations/{externalAccountId}/{externalEventId}/breakdown: get: tags: - Participant State summary: >- Lire la répartition des participations par identifiant externe d'événement marketing description: >- Lisez la répartition des participations à l'événement marketing avec des filtres optionnels par paire externalAccountId et externalEventId. operationId: >- get-/marketing/v3/marketing-events/participations/{externalAccountId}/{externalEventId}/breakdown_getParticipationsBreakdownByExternalEventId parameters: - name: externalAccountId in: path description: >- L'identifiant du compte associé à cet événement marketing dans l'application d'événement externe. required: true style: simple explode: false schema: type: string - name: externalEventId in: path description: >- L'identifiant de l'événement marketing dans l'application d'événements externe. required: true style: simple explode: false schema: type: string - name: after in: query description: Le curseur indiquant la position du dernier élément récupéré. required: false style: form explode: true schema: type: string - name: contactIdentifier in: query description: >- L'identifiant du contact. Cela peut être l'e-mail ou l'identifiant interne. required: false style: form explode: true schema: type: string - name: limit in: query description: >- La limite de taille de la réponse. La valeur par défaut est 10, le nombre maximal est 100. required: false style: form explode: true schema: type: integer format: int32 default: 10 - name: state in: query description: "La valeur de l'état de participation\_ : INSCRIT, ANNULÉ, PARTICIPÉ, NO_SHOW" required: false style: form explode: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponseWithTotalParticipationBreakdown default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.marketing_events.read components: schemas: CollectionResponseWithTotalParticipationBreakdown: required: - results - total type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array items: $ref: '#/components/schemas/ParticipationBreakdown' total: type: integer 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. ParticipationBreakdown: required: - associations - createdAt - id - properties type: object properties: associations: $ref: '#/components/schemas/ParticipationAssociations' createdAt: type: string description: Date et heure de création de l'événement marketing ciblé format: date-time id: type: string description: L'identifiant interne de l'événement marketing cible properties: $ref: '#/components/schemas/ParticipationProperties' 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: L'élément ID au début de la page link: type: string description: Lien vers la page suivante description: >- Spécifie les informations de pagination nécessaires pour récupérer le prochain ensemble de résultats dans une réponse d'API paginée PreviousPage: required: - before type: object properties: before: type: string description: A paging cursor token for retrieving previous pages. link: type: string description: A URL that can be used to retrieve the previous pages' results. description: >- specifies the paging information needed to retrieve the previous set of results in a paginated API response ParticipationAssociations: required: - contact - marketingEvent type: object properties: contact: $ref: '#/components/schemas/ContactAssociation' marketingEvent: $ref: '#/components/schemas/MarketingEventAssociation' ParticipationProperties: required: - attendanceState - occurredAt type: object properties: attendanceDurationSeconds: type: integer description: Le nombre de secondes pendant lesquelles la participation a duré format: int32 attendancePercentage: type: string description: >- Pourcentage de la durée de participation par rapport à la durée de l'événement attendanceState: type: string description: L'état de la participation enum: - ATTENDED - CANCELLED - EMPTY - NO_SHOW - REGISTERED occurredAt: type: integer description: Horodatage du moment où la participation a eu lieu format: int64 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. ContactAssociation: required: - contactId - email type: object properties: contactId: type: string description: L'identifiant interne du contact dans HubSpot email: type: string description: L'adresse e-mail du contact dans HubSpot firstname: type: string description: Le prénom du contact dans HubSpot lastname: type: string description: Le nom de famille du contact dans HubSpot MarketingEventAssociation: required: - marketingEventId - name type: object properties: externalAccountId: type: string description: >- L'ID de compte associé à cet événement marketing dans l'application d'événements externes. externalEventId: type: string description: >- L'ID d'événement associé à cet événement marketing dans l'application d'événements externe. marketingEventId: type: string description: L'ID interne de l'événement marketing dans HubSpot name: type: string description: Le nom de l'événement marketing dans HubSpot 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: crm.objects.marketing_events.read: '' crm.objects.marketing_events.write: '' ````