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

> Retrieve conversations that have unread messages. Use this to build inbox-style notification flows.

# Retrieve unread conversations



## OpenAPI

````yaml get /v1/messaging/messages/inbox
openapi: 3.0.0
info:
  title: Partner API
  description: Public API for partner integrations
  version: '1.0'
  contact: {}
servers:
  - url: https://api-staging.respondent.io
security: []
tags: []
paths:
  /v1/messaging/messages/inbox:
    get:
      tags:
        - messaging
      summary: Retrieve unread conversations
      description: Get all conversations with unread messages.
      operationId: MessagesController_getInbox
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
        - name: x-api-secret
          in: header
          required: true
          schema:
            type: string
        - name: externalResearcherId
          required: false
          in: query
          description: Filter by external researcher id.
          schema:
            type: string
        - name: projectId
          required: false
          in: query
          description: Filter by projectId.
          schema:
            type: string
            format: ObjectId
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageInboxDto'
components:
  schemas:
    MessageInboxDto:
      type: object
      properties:
        read:
          type: boolean
          description: All conversations in the inbox have been read.
        count:
          type: number
          description: Count of conversations user is in.
        unreadIds:
          description: List of unread conversations uids.
          type: array
          items:
            type: string
        unreadCount:
          type: number
          description: Count of unread conversations in the inbox.
      required:
        - read
        - count
        - unreadIds
        - unreadCount

````