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

# List Messages

> Guest session access requires no account or API key. Retain the returned conversationToken and send X-Assist-Token on follow-ups. Guest limits and sign-in gates apply. The server checks current session access and resource permissions on every request. Acceptance does not prove provider execution.

Read paginated durable messages, authorship, routing results and operation references. Pass the returned `nextBefore` cursor to read earlier history. Reading never starts or repeats work.


## OpenAPI

````yaml openapi-v3.json GET /v3/sessions/{sessionId}/messages
openapi: 3.1.0
info:
  title: Navigator
  version: 3.0.0
servers:
  - url: https://api.darwin.so/api
security: []
paths:
  /v3/sessions/{sessionId}/messages:
    get:
      tags:
        - Sessions
      summary: List Messages
      description: >-
        Guest session access requires no account or API key. Retain the returned
        conversationToken and send X-Assist-Token on follow-ups. Guest limits
        and sign-in gates apply. The server checks current session access and
        resource permissions on every request. Acceptance does not prove
        provider execution.
      operationId: list_session_messages
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
            pattern: ^asst_[a-f0-9-]{36}$
        - name: before
          in: query
          schema:
            type: string
        - name: audience
          in: query
          required: false
          description: >-
            Presentation consumer. Agent returns Markdown and structured facts;
            human also receives DarwinUI. This does not change identity,
            permissions or approvals.
          schema:
            type: string
            enum:
              - human
              - agent
            default: agent
      responses:
        '200':
          description: Accepted state.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid request.
        '401':
          description: Authentication required.
        '403':
          description: Current access or resource authority denied.
        '404':
          description: Not found.
        '409':
          description: Idempotency or revision conflict.
        '429':
          description: >-
            Request rate or guest session allowance exceeded. The error code
            distinguishes message, operation, agent and concurrency limits.
        '503':
          description: Service unavailable.
      security:
        - apiKey: []
        - bearer: []
        - assistToken: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      type: http
      scheme: bearer
    assistToken:
      type: apiKey
      in: header
      name: X-Assist-Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.