> ## 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 Event by ID

> Get a single event by its event_id.

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /api/v1/events/{event_id}
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/{event_id}:
    get:
      tags:
        - Events
      summary: Get Event by ID
      description: Get a single event by its event_id.
      operationId: get-event-by-id
      parameters:
        - name: event_id
          in: path
          required: true
          schema:
            type: string
            example: 4be8fed5-f9db-41ef-a107-c20c3339998d
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '401':
          description: Authentication information is missing or invalid.
        '404':
          description: An event with the provided event_id was not found.
      security:
        - ApiKeyAuth: []
components:
  schemas:
    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

````