---
title: "Read participations breakdown by Marketing Event internal identifier"
method: GET
path: "/marketing/marketing-events/2026-03/participations/{marketingEventId}/breakdown"
tags: ["Participant State"]
---

# Read participations breakdown by Marketing Event internal identifier

`GET /marketing/marketing-events/2026-03/participations/{marketingEventId}/breakdown`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/marketing-events/2026-03/participations/{marketingEventId}/breakdown`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `hapikey`
  - none

Read Marketing event's participations breakdown with optional filters by internal identifier marketingEventId.

## Path parameters

- `marketingEventId` integer, required

## Query parameters

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

## Response `200`

successful operation

- MarketingMarketingEventsCollectionResponseWithTotalParticipationBreakdown
  - `paging` Paging
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A paging cursor token for retrieving subsequent pages.
      - `link` string: A URL that can be used to retrieve the next page results.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string token used to identify the position before the current page in the pagination sequence.
      - `link` string: A URL string that provides a direct link to the previous page of results.
  - `results` MarketingMarketingEventsParticipationBreakdown[], required
    - `associations` MarketingMarketingEventsParticipationAssociations, required
      - `contact` MarketingMarketingEventsContactAssociation, 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` MarketingMarketingEventsMarketingEventAssociation, 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` MarketingMarketingEventsParticipationProperties, 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

## Other responses

- `default`: An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9`: 1 info
  - api operation id `get-/marketing/marketing-events/2026-03/participations/{marketingEventId}/breakdown_getParticipationsBreakdownByMarketingEventId` removed and replaced with `get-/marketing/marketing-events/2026-03/participations/{marketingEventId}/breakdown`
- **2026-03-25** `62586336cea2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/marketing/marketing-events/2026-03/participations/:marketingEventId/breakdown/get.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) - [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/hubspot-api-specification/revisions/f9c7181056c5?raw)