> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heybee.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Activity Timeline

> Adaptive vote-over-time series (window and resolution sized from the real vote span).



## OpenAPI

````yaml /openapi.json get /v1/experiments/{experiment_id}/activity-timeline
openapi: 3.1.0
info:
  description: Customer-owned evaluation lifecycle API.
  title: HeyBee Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.heybee.app
security: []
paths:
  /v1/experiments/{experiment_id}/activity-timeline:
    get:
      tags:
        - Analytics
      summary: Get Activity Timeline
      description: >-
        Adaptive vote-over-time series (window and resolution sized from the
        real vote span).
      operationId: >-
        get_activity_timeline_v1_experiments__experiment_id__activity_timeline_get
      parameters:
        - in: path
          name: experiment_id
          required: true
          schema:
            format: uuid
            title: Experiment Id
            type: string
        - in: header
          name: authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityTimelineResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    ActivityTimelineResponse:
      description: >-
        Adaptive vote-over-time series: window and resolution chosen from the
        real data span.


        `bucket_seconds` is the chosen resolution; `start`/`end` are the window
        bounds

        (epoch ms, UTC, snapped to bucket boundaries); `ongoing` is true when
        the last

        vote is recent (the series runs to now) and false when voting has
        stopped.

        `points` holds only non-empty buckets; the client zero-fills the rest.
      properties:
        bucket_seconds:
          title: Bucket Seconds
          type: integer
        end:
          title: End
          type: integer
        ongoing:
          title: Ongoing
          type: boolean
        points:
          items:
            $ref: '#/components/schemas/ActivityTimelineBucketResponse'
          title: Points
          type: array
        start:
          title: Start
          type: integer
      required:
        - bucket_seconds
        - start
        - end
        - ongoing
      title: ActivityTimelineResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ActivityTimelineBucketResponse:
      description: One bucket of the adaptive vote-over-time series.
      properties:
        feedback:
          title: Feedback
          type: integer
        t:
          title: T
          type: integer
        votes:
          title: Votes
          type: integer
      required:
        - t
        - votes
        - feedback
      title: ActivityTimelineBucketResponse
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: Supabase JWT
      scheme: bearer
      type: http
    ApiKeyAuth:
      in: header
      name: X-API-Key
      type: apiKey

````