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

# Get usage events



## OpenAPI

````yaml /openapi-components.json get /api/v1/usage/events
openapi: 3.0.0
info:
  title: StudyFetch API
  description: API documentation for StudyFetch
  version: '1.0'
  contact: {}
servers:
  - url: https://studyfetchapi.com
    description: Production API Server
security: []
tags: []
paths:
  /api/v1/usage/events:
    get:
      tags:
        - Usage Tracking
      summary: Get usage events
      operationId: getUsageEvents
      parameters:
        - name: startDate
          required: false
          in: query
          description: Start date for filtering (ISO 8601)
          schema:
            type: string
        - name: endDate
          required: false
          in: query
          description: End date for filtering (ISO 8601)
          schema:
            type: string
        - name: eventType
          required: false
          in: query
          description: Filter by event type
          schema:
            enum:
              - material_created
              - material_uploaded
              - material_processed
              - material_deleted
              - component_created
              - component_accessed
              - component_deleted
              - component_usage
              - chat_message_sent
              - chat_session_started
              - chat_session_ended
              - chat_feedback
              - test_created
              - test_started
              - test_completed
              - test_question_answered
              - test_retaken
              - audio_recap_create
              - assignment_grader_create
              - api_call
              - cache_hit
              - sso_login
              - sso_logout
              - student_performance
            type: string
        - name: userId
          required: false
          in: query
          description: Filter by user ID
          schema:
            type: string
        - name: groupId
          required: false
          in: query
          description: Filter by group ID
          schema:
            type: string
        - name: resourceId
          required: false
          in: query
          description: Filter by resource ID
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Number of results to return
          schema:
            minimum: 1
            maximum: 1000
            default: 100
            type: number
        - name: offset
          required: false
          in: query
          description: Offset for pagination
          schema:
            minimum: 0
            default: 0
            type: number
      responses:
        '200':
          description: Usage events retrieved
      security:
        - x-api-key: []
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API Key for server-to-server authentication. Resolves to the owning
        organization.

````