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

# Retrieve an event summary



## OpenAPI

````yaml https://api.quartr.com/public/v3/openapi.json get /public/v3/events/{id}/summary
openapi: 3.0.0
info:
  title: Quartr Public API
  description: The Quartr Public API
  version: '3.0'
  contact: {}
servers:
  - url: https://api.quartr.com
security: []
tags:
  - name: Companies
    description: ''
  - name: Events
    description: ''
  - name: Event Types
    description: ''
  - name: Documents
    description: ''
  - name: Document Types
    description: ''
  - name: Reports
    description: ''
  - name: Slides
    description: ''
  - name: Transcripts
    description: ''
  - name: Backlog Audio
    description: ''
  - name: Live
    description: ''
  - name: Live Audio
    description: ''
  - name: Live Transcripts
    description: ''
paths:
  /public/v3/events/{id}/summary:
    get:
      tags:
        - Events
      summary: Retrieve an event summary
      operationId: EventSummaryControllerV3_getSummary
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: number
        - name: length
          required: false
          in: query
          description: Length preset for the summary.
          schema:
            default: short
            example: long
            enum:
              - line
              - short
              - long
            type: string
        - name: plain
          required: false
          in: query
          description: Plain text summary without document sources embedded.
          schema:
            default: false
            example: true
            type: boolean
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SummaryResponseDto'
        '401':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Unauthorized
                    type: string
                  statusCode:
                    example: 401
                    type: number
                type: object
        '403':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Forbidden
                    type: string
                  statusCode:
                    example: 403
                    type: number
                type: object
      security:
        - apiKey: []
components:
  schemas:
    SummaryResponseDto:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/SummaryDto'
      required:
        - data
    SummaryDto:
      type: object
      properties:
        id:
          type: number
          example: 1343
        summary:
          type: string
          example: >-
            Q2 FY24 saw revenue decline and net loss, but IPO-driven debt
            reduction strengthened the balance
            sheet.<document-source>documentData_20677_20051795_17</document-source><document-source>documentData_20677_20051818_5</document-source>
        sources:
          type: array
          items:
            $ref: '#/components/schemas/SummarySource'
        createdAt:
          format: date-time
          type: string
          example: '2025-01-01T00:00:00.000Z'
        updatedAt:
          format: date-time
          type: string
          example: '2025-01-01T00:00:00.000Z'
      required:
        - id
        - summary
        - sources
        - createdAt
        - updatedAt
    SummarySource:
      type: object
      properties:
        sourceId:
          type: string
          example: documentData_4742_15110876_1
          description: >-
            Id used for linking to the source document to tags embedded in the
            summary
        documentId:
          type: number
          example: 3456
        page:
          type: number
          example: 2
          description: Page number or timestamp in seconds depending on the document type
        timestamp:
          type: number
          example: 110
          description: Timestamp in seconds
        typeId:
          type: number
          example: 10
          description: Document type id
      required:
        - documentId
        - typeId
  securitySchemes:
    apiKey:
      in: header
      name: x-api-key
      type: apiKey

````