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

# Get in-app notifications

> Retrieves all in-app notifications for the authenticated user. Rate limit: 1 request per second.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/notifications/messages
openapi: 3.0.1
info:
  title: eToro Api
  version: v1.206.0
  description: >-
    eToro’s public API provides access to real-time financial data, trading
    insights, and account management features, allowing developers to integrate
    eToro’s services into their applications. With access to market prices,
    historical data, and social trading information, the API empowers users to
    enhance their trading strategies. Designed for security and scalability, the
    eToro API ensures smooth and reliable integration for a variety of financial
    applications.


    For more details on integrating with eToro's public WebSocket service,
    please refer to the dedicated [WebSocket
    documentation](./websocket/websocket-doc.html).
servers:
  - url: https://public-api.etoro.com
    description: eToro Public API
security: []
tags:
  - name: Agent Portfolios
  - name: Watchlists
  - name: Feeds
  - name: Asset Explorer
  - name: Market Data
  - name: Identity
  - name: Notifications
  - name: PI Data
  - name: Comments
  - name: Trading Demo
  - name: Trading Real
  - name: Users Info
  - name: Deprecated
paths:
  /api/v1/notifications/messages:
    get:
      tags:
        - Notifications
      summary: Get in-app notifications
      description: >-
        Retrieves all in-app notifications for the authenticated user. Rate
        limit: 1 request per second.
      operationId: getInAppNotifications
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: fbab24d7-94b8-4b62-a8cd-fcef4835ad21
          description: A unique request identifier.
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
          description: API key for authentication.
        - name: x-user-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: >-
              eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
          description: User-specific authentication key.
      responses:
        '200':
          description: Notifications retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InAppNotificationsResult'
        '401':
          description: Unauthorized
        '422':
          description: Validation failed
components:
  schemas:
    InAppNotificationsResult:
      type: object
      description: Response containing notifications and metadata
      properties:
        messages:
          type: array
          description: List of notification messages
          items:
            $ref: '#/components/schemas/InAppNotificationMessage'
        meta:
          $ref: '#/components/schemas/InAppNotificationsMetadata'
    InAppNotificationMessage:
      type: object
      description: A single in-app notification message
      properties:
        messageId:
          type: string
          format: uuid
          description: Unique identifier of the notification message
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        correlationId:
          type: string
          format: uuid
          description: Correlation ID for request tracing
        actionLink:
          type: string
          description: URL for the notification action
        imageTitle:
          type: string
          description: Title for the notification image
        imageUrl:
          type: string
          description: URL of the notification image
        notificationType:
          type: string
          description: Type of notification
        version:
          type: string
          description: Version of the notification format
        aggregatable:
          type: boolean
          description: Whether this notification can be aggregated
        grouped:
          type: boolean
          description: Whether this notification is grouped
        aggregationId:
          type: string
          description: ID for aggregation grouping
        message:
          type: string
          description: Notification content text
        readStatus:
          type: string
          enum:
            - New
            - Seen
            - Read
          description: Current read status of the notification
        publishDate:
          type: string
          format: date-time
          description: When the notification was published
        subCategory:
          type: string
          description: Sub-category of the notification
        category:
          type: string
          description: Category of the notification
        rtlLanguage:
          type: boolean
          description: Whether the notification content is in an RTL language
        section:
          type: string
          description: Section the notification belongs to
    InAppNotificationsMetadata:
      type: object
      description: Metadata about the notifications result
      properties:
        notSeen:
          type: integer
          format: int32
          description: Count of unseen notifications
          example: 5

````