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

# Get Events

> Get a paginated list of events.

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "data": [
      {
        "event_id": "4be8fed5-f9db-41ef-a107-c20c3339998d",
        "title": "Example Corp reports Q1 earnings beat",
        "headline": "Example Corp tops Q1 estimates on strong product demand.",
        "description": "Example Corp reported quarterly earnings that exceeded analyst expectations, driven by higher product demand and improved operating margins.",
        "symbol": "EXMP",
        "exchange": "XNAS",
        "figis": [
          "BBG000BXXXXX"
        ],
        "event_type": "EARNINGS",
        "source": "PRESS_RELEASE",
        "sentiment": 0.82,
        "occurred_at": "2025-04-23T11:34:15-04:00",
        "created_at": "2025-04-23T15:34:15Z",
        "updated_at": "2025-04-23T15:34:15Z",
        "securities": [
          {
            "figi": "BBG000BXXXXX",
            "isin": "US0000000000",
            "name": "EXAMPLE CORP",
            "symbol": "EXMP",
            "mic_code": "XNAS",
            "figi_composite": "BBG000BXXXXX",
            "figi_share_class": "BBG001SXXXXX",
            "refinitiv_exch_code": "NAS"
          }
        ]
      }
    ],
    "message": "Successfully fetched events",
    "pagination": {
      "hits": 1,
      "page": 1,
      "page_count": 1,
      "page_size": 18
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /api/v1/events
openapi: 3.0.0
info:
  title: Events
  version: 1.0.0
  description: >-
    This REST API provides endpoints to fetch market-moving events and their
    associated metadata.
servers:
  - url: https://api.finvera.news/delivery
    description: Production server
security: []
paths:
  /api/v1/events:
    get:
      tags:
        - Events
      summary: Get Events
      description: Get a paginated list of events.
      operationId: get-events
      parameters:
        - name: symbol
          description: Filter by stock symbol
          in: query
          schema:
            type: string
            example: AAPL
        - name: from
          description: from date in ISO 8601 format, YYYY-MM-DDTHH:MM:SS
          in: query
          schema:
            type: string
            example: '2025-05-02T00:00:00'
        - name: to
          description: to date in ISO 8601 format, YYYY-MM-DDTHH:MM:SS
          in: query
          schema:
            type: string
            example: '2025-05-02T00:00:00'
        - name: page
          description: page number for pagination
          in: query
          schema:
            type: integer
            example: '1'
        - name: page_size
          description: page size for pagination
          in: query
          schema:
            type: integer
            default: '10'
            example: '18'
        - name: securities
          description: include linked securities data in the response
          in: query
          schema:
            type: boolean
            example: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventsResponse'
        '401':
          description: Authentication information is missing or invalid.
        '404':
          description: No events were found for the provided query.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    EventsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Event'
        message:
          type: string
          description: A message indicating the status of the request.
        pagination:
          type: object
          properties:
            hits:
              type: integer
              description: total number of results matching the query.
            page:
              type: integer
              description: current page number.
            page_count:
              type: integer
              description: total number of pages available.
            page_size:
              type: integer
              description: number of results per page.
    Event:
      type: object
      properties:
        event_id:
          type: string
          description: Unique identifier for the event.
        title:
          type: string
          description: Short title describing the event.
        headline:
          type: string
          description: Generated headline summarizing the event.
        description:
          type: string
          description: Longer description of the event.
        symbol:
          type: string
          description: Primary ticker symbol associated with the event.
        exchange:
          type: string
          description: Exchange where the primary stock is listed.
        figis:
          type: array
          description: List of FIGI share class identifiers related to the event.
          items:
            type: string
        event_type:
          type: string
          description: Category of the event (e.g. EARNINGS, MERGER, GUIDANCE).
        source:
          type: string
          description: Source of the event signal.
        sentiment:
          type: number
          format: float
          description: Sentiment score associated with the event.
        occurred_at:
          type: string
          format: date-time
          description: ISO8601 timestamp when the event occurred.
        created_at:
          type: string
          format: date-time
          description: Timestamp of event record creation.
        updated_at:
          type: string
          format: date-time
          description: Timestamp of the last update to the event record.
        securities:
          type: array
          items:
            $ref: '#/components/schemas/Security'
    Security:
      type: object
      properties:
        figi:
          type: string
        isin:
          type: string
        name:
          type: string
        symbol:
          type: string
        mic_code:
          type: string
        figi_composite:
          type: string
        figi_share_class:
          type: string
        refinitiv_exch_code:
          type: string
  securitySchemes:
    ApiKeyAuth:
      in: query
      name: apikey
      type: apiKey

````