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

# List Chat Room Stories

> Returns a paginated list of messages (stories) for a specific chat room. Supports cursor-based pagination and optional text search.



## OpenAPI

````yaml GET /v1/master-inbox/rooms/{roomId}/stories
openapi: 3.1.0
info:
  title: Getmany Service API
  description: This is the reference documentation and schemas for the Getmany Service API.
  version: 1.0.0
servers:
  - url: https://api.getmany.io/service
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agency
    description: >-
      Agency information tied to the workspace, including agency profile
      details, seat-holders in an agency, and aggregated proposal performance
      stats
  - name: Job Searches
    description: Saved search configurations that scan the Upwork market
  - name: Jobs Feed
    description: >-
      Endpoints related to retrieving the jobs list matching with a job search
      configuration
  - name: Bid Intents
    description: List and manage bidding intents
  - name: Miscellaneous
    description: Various general purpose endpoints
  - name: Master Inbox
    description: Chat room management and messaging endpoints
paths:
  /v1/master-inbox/rooms/{roomId}/stories:
    get:
      tags:
        - Master Inbox
      summary: List chat room stories
      description: >-
        Returns a paginated list of messages (stories) for a specific chat room.
        Supports cursor-based pagination and optional text search.
      operationId: getV1Master-inboxRoomsByRoomIdStories
      parameters:
        - name: roomId
          in: path
          required: true
          schema:
            type: string
        - in: query
          name: pageCursor
          schema:
            type: string
        - in: query
          name: pageSize
          schema:
            type: string
        - in: query
          name: search
          schema:
            type: string
      responses:
        '200':
          description: Paginated chat stories with room participants
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        storyId:
                          type: string
                          description: Upwork story ID.
                        userId:
                          type:
                            - string
                            - 'null'
                          description: Upwork user ID of the sender.
                        userName:
                          type: string
                          description: Display name of the sender.
                        userPhotoUrl:
                          type: string
                          description: Avatar URL of the sender.
                        message:
                          type: string
                          description: Message text content.
                        createdAt:
                          type: string
                          format: date-time
                          description: When the message was sent (ISO-8601).
                        attachments:
                          type: array
                          items:
                            type: object
                            properties:
                              objectReferenceId:
                                type: string
                                description: Reference ID of the attached object.
                              objectType:
                                type: string
                                description: Type of the attached object.
                              metadata:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    key:
                                      type: string
                                      description: Metadata key.
                                    value:
                                      type: string
                                      description: Metadata value.
                                  required:
                                    - key
                                    - value
                                description: Key-value metadata pairs for the attachment.
                          description: Message attachments.
                      required:
                        - storyId
                        - userId
                        - userName
                        - userPhotoUrl
                        - message
                        - createdAt
                  meta:
                    type: object
                    properties:
                      pageSize:
                        type: number
                      nextCursor:
                        type:
                          - string
                          - 'null'
                    required:
                      - pageSize
                      - nextCursor
                required:
                  - data
                  - meta
        '404':
          description: Room not found or deleted
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: number
                  detail:
                    type: string
                  instance:
                    type: string
                    format: uri
                required:
                  - type
                  - title
                  - status
                  - detail
                  - instance
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````