---
title: "Get bucketed Pulse stats"
method: GET
path: "/v1/meetings/{meetingId}/pulse/{bucket}"
tags: ["Pulse"]
---

# Get bucketed Pulse stats

`GET /v1/meetings/{meetingId}/pulse/{bucket}`

## Request

- Base URL: `https://app.meet.ps/api`
- URL: `https://app.meet.ps/api/v1/meetings/{meetingId}/pulse/{bucket}`
- Auth: HTTP bearer

This endpoint processes raw pulse events and serves aggregate data useful for drawing charts.

Data is binned using an interval of 10 seconds by default - this can be changed by providing an optional parameter, bucket. Allowed range is 5 to 60 seconds. Using a larger bin will prolong the apparent "decay" in the number of simultaneous pulses of the same type and vice versa.

A **meeting role** of an *owner*, *presenter*, *reporter* or *auditor* is required to access this data.

## Path parameters

- `meetingId` string, required: A canonical meeting ID string that's generated automatically for new meetings. Normally consists of just alphanumericals; legacy meetings can have dashes and underscores.
- `bucket` integer, required

## Response `200`

List of Pulse datapoints

- object
  - `result` object
    - `bucketSize` integer: The chosen bucket time, in milliseconds
    - `yMax` integer: Max total number of Pulses of any given type encountered at any bucket interval - useful to set the Y limit for charts
    - `startTime` integer: Timestamp for the first datapoint, in ms.
    - `length` integer: Total even duration covered by the datapoints
    - `series` object[]

## Other responses

- `401`: Access token is missing or invalid
- `403`: A meeting-specific role is missing to perform an action
- `404`: Reference meeting not found

---

[API](https://skmtc.dev/meet/apis/meetingpulse-api.md) · [All operations](https://skmtc.dev/meet/apis/meetingpulse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meet/apis/meetingpulse-api/revisions/dc29466adc0e?raw)