---
title: "Read participations breakdown by Contact identifier"
method: GET
path: "/marketing/v3/marketing-events/participations/contacts/{contactIdentifier}/breakdown"
tags: ["Participant State"]
---

# Read participations breakdown by Contact identifier

`GET /marketing/v3/marketing-events/participations/contacts/{contactIdentifier}/breakdown`

Read Contact's participations by identifier - email or internal id.

## Path parameters

- `contactIdentifier` string, required

## Query parameters

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

## Response `200`

successful operation

- CollectionResponseWithTotalParticipationBreakdown
  - `paging` Paging
    - `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 paging cursor token for retrieving previous pages.
      - `link` string — A URL that can be used to retrieve the previous pages' results.
  - `results` ParticipationBreakdown[], required
    - `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

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/marketing-marketing-events.md) · [All operations](https://skmtc.net/hubspot/apis/marketing-marketing-events/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/marketing-marketing-events/revisions/e1f0e463c8c3/schema)