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

# List Events



## OpenAPI

````yaml get /api/v2/event/list
openapi: 3.0.0
info:
  version: 1.0.0
  title: Octave API
  description: API for Octave workspace management and AI-powered content generation
servers:
  - url: https://app.octavehq.com
security:
  - ApiKeyAuth: []
paths:
  /api/v2/event/list:
    get:
      tags:
        - Events
      summary: List Events
      operationId: listEvents
      parameters:
        - schema:
            type: string
            format: date-time
            description: Start of the time range (ISO 8601 datetime)
          required: true
          name: startDate
          in: query
        - schema:
            type: string
            format: date-time
            description: End of the time range (ISO 8601 datetime). Defaults to now.
          required: false
          name: endDate
          in: query
        - schema:
            type: integer
            nullable: true
            maximum: 100
            default: 20
            description: Maximum number of events to return (max 100)
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            nullable: true
            default: 0
            description: Number of events to skip for pagination
          required: false
          name: offset
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - EMAIL_SENT
                - EMAIL_REPLY_RECEIVED
                - CALL_TRANSCRIPT
                - DEAL_WON
                - DEAL_LOST
                - OPPORTUNITY_CREATED
                - MEETING_BOOKED
                - RESOURCE_INDEXED
                - RESOURCE_REINDEXED
                - ENTITY_CREATED
                - ENTITY_UPDATED
                - SOCIAL_MESSAGE_SENT
                - SOCIAL_MESSAGE_RECEIVED
                - SOCIAL_CONNECTION_SENT
                - SOCIAL_CONNECTION_ACCEPTED
                - AD_SET_PUBLISHED
                - AD_PERFORMANCE_SNAPSHOT
                - BULK_IMPORT_SUMMARY
                - PROCESSING_NOT_APPLICABLE
                - PROVIDER_EVENT_TYPE_UNKNOWN
                - UNKNOWN
            description: Filter by event types
          required: false
          name: eventTypes
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - EMAIL
                - CALL
                - CRM
                - RESOURCE
                - REVISION
                - SOCIAL
                - ADS
                - UNKNOWN
            description: Filter by event categories
          required: false
          name: eventCategories
          in: query
      responses:
        '200':
          description: List of events for the workspace
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      events:
                        type: array
                        items:
                          type: object
                          properties:
                            oId:
                              type: string
                            eventType:
                              type: string
                              enum:
                                - EMAIL_SENT
                                - EMAIL_REPLY_RECEIVED
                                - CALL_TRANSCRIPT
                                - DEAL_WON
                                - DEAL_LOST
                                - OPPORTUNITY_CREATED
                                - MEETING_BOOKED
                                - RESOURCE_INDEXED
                                - RESOURCE_REINDEXED
                                - ENTITY_CREATED
                                - ENTITY_UPDATED
                                - SOCIAL_MESSAGE_SENT
                                - SOCIAL_MESSAGE_RECEIVED
                                - SOCIAL_CONNECTION_SENT
                                - SOCIAL_CONNECTION_ACCEPTED
                                - AD_SET_PUBLISHED
                                - AD_PERFORMANCE_SNAPSHOT
                                - BULK_IMPORT_SUMMARY
                                - PROCESSING_NOT_APPLICABLE
                                - PROVIDER_EVENT_TYPE_UNKNOWN
                                - UNKNOWN
                            eventTimestamp:
                              type: string
                              nullable: true
                            processingStatus:
                              type: string
                            providerName:
                              type: string
                            eventSummary:
                              type: string
                          required:
                            - oId
                            - eventType
                            - eventTimestamp
                      total:
                        type: integer
                      hasMore:
                        type: boolean
                    required:
                      - events
                      - total
                      - hasMore
                required:
                  - data
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````