---
title: "Read participations breakdown by Marketing Event external identifier"
method: GET
path: "/marketing/marketing-events/2026-09/participations/{externalAccountId}/{externalEventId}/breakdown"
tags: ["Participant State"]
---

# Read participations breakdown by Marketing Event external identifier

`GET /marketing/marketing-events/2026-09/participations/{externalAccountId}/{externalEventId}/breakdown`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/marketing-events/2026-09/participations/{externalAccountId}/{externalEventId}/breakdown`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.marketing_events.read`

Read Marketing event's participations breakdown with optional filters by externalAccountId and externalEventId pair.

## Path parameters

- `externalAccountId` string, required
- `externalEventId` string, required

## Query parameters

- `after` string
- `contactIdentifier` string
- `limit` integer
- `state` string

## Response `200`

successful operation

- CollectionResponseWithTotalParticipationBreakdown
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: The ID element at the start of the page
      - `link` string: Link to the next page
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string that serves as a cursor indicating the position before the first item in the current set of results, used to fetch the previous set of results.
      - `link` string: A string containing the URL link to the previous page of results.
  - `results` ParticipationBreakdown[], required: An array of participation breakdown objects, each detailing a specific participation instance.
    - `associations` ParticipationAssociations, required
      - `contact` ContactAssociation, required
        - `contactId` string, required: The internal ID of the contact in HubSpot
        - `email` string, required: The email of the contact in HubSpot
        - `firstname` string: The first name of the contact in HubSpot
        - `lastname` string: The last name of the contact in HubSpot
      - `marketingEvent` MarketingEventAssociation, required
        - `externalAccountId` string: The account ID that is associated with this marketing event in the external event application
        - `externalEventId` string: The event ID that is associated with this marketing event in the external event application
        - `marketingEventId` string, required: The internal ID of the marketing event in HubSpot
        - `name` string, required: The name of the marketing event in HubSpot
    - `createdAt` string, date-time, required: The creation time and date of the target marketing event
    - `id` string, required: The internal ID of the target marketing event
    - `properties` ParticipationProperties, required
      - `attendanceDurationSeconds` integer: The number of seconds the participation lasted
      - `attendancePercentage` string: Percentage of the participation duration relative to the event duration
      - `attendanceState` 'ATTENDED' | 'CANCELLED' | 'EMPTY' | 'NO_SHOW' | 'REGISTERED', required: The state of the participation
      - `occurredAt` integer, required: Timestamp of when the participation occurred
  - `total` integer, required: An integer representing the total number of participation breakdowns available.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `e62ad9a49a20`: 1 info
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/marketing-marketing-events/changes/marketing/marketing-events/2026-09/participations/:externalAccountId/:externalEventId/breakdown/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-marketing-events.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-marketing-events/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-marketing-events/revisions/3afcf69ad1b4?raw)