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

# List Messages



## OpenAPI

````yaml get /v1/channels/{channelId}/conversations/{conversationId}/messages
openapi: 3.1.0
info:
  version: 1.0.0
  title: every public api
servers:
  - url: https://api.goevery.co
security:
  - bearerAuth: []
paths:
  /v1/channels/{channelId}/conversations/{conversationId}/messages:
    get:
      parameters:
        - schema:
            type: string
            description: The unique identifier of the channel.
            example: 6633a1b2c4d5e6f7a8b9c0d1
          required: true
          description: The unique identifier of the channel.
          name: channelId
          in: path
        - schema:
            type: string
            description: The unique identifier of the conversation.
            example: 664fa2b3c4d5e6f7a8b9c0d2
          required: true
          description: The unique identifier of the conversation.
          name: conversationId
          in: path
        - schema:
            type:
              - number
              - 'null'
            exclusiveMinimum: 0
            maximum: 100
            example: 20
          required: false
          name: pageSize
          in: query
          description: >-
            The maximum number of messages to return. Defaults to 20 if not
            specified. Maximum 100.
        - schema:
            type:
              - string
              - 'null'
          required: false
          name: pageToken
          in: query
          description: A token to retrieve the next page of results.
      responses:
        '200':
          description: Successfully retrieved list of messages.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMessagesResponse'
components:
  schemas:
    ListMessagesResponse:
      type: object
      properties:
        messages:
          type: array
          items:
            $ref: '#/components/schemas/Message'
          description: An array of messages, newest first.
        nextPageToken:
          type:
            - string
            - 'null'
          description: A token to retrieve the next page of results, if any.
      required:
        - messages
    Message:
      type: object
      properties:
        name:
          type: string
          description: The resource name of the message.
          example: >-
            channels/6633a1b2c4d5e6f7a8b9c0d1/conversations/664fa2b3c4d5e6f7a8b9c0d2/messages/665ab3c4d5e6f7a8b9c0d3e4
        createTime:
          type: string
          format: date-time
          description: The timestamp when the message was created.
          example: '2026-04-03T10:00:00Z'
        status:
          type: string
          enum:
            - SENDING
            - SENT
            - DELIVERED
            - READ
            - FAILED
          description: The delivery status of the message.
          example: SENDING
        contentType:
          type: string
          enum:
            - TEXT
            - TEMPLATE
          description: The content type of the message.
          example: TEXT
        text:
          type: string
          description: The text content. Present when contentType is TEXT.
          example: Your order has been confirmed.
        template:
          $ref: '#/components/schemas/TemplateContent'
      required:
        - name
        - createTime
        - status
        - contentType
    TemplateContent:
      type: object
      properties:
        name:
          type: string
          description: The template display name on the messaging platform.
          example: order_status_update
        language:
          type: string
          description: The BCP-47 language code for the template.
          example: es
        headerParameters:
          type: object
          additionalProperties:
            type: string
          description: Parameter values for the header component.
          example:
            customerName: Juan
        bodyParameters:
          type: object
          additionalProperties:
            type: string
          description: Parameter values for the body component.
          example:
            orderNumber: '12345'
            status: confirmado
      required:
        - name
        - language
      description: The template content. Present when contentType is TEMPLATE.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````