---
title: "Get messages from a playground session"
description: "Retrieve messages from a playground session with optional filtering.\nSupports polling via the `since` parameter to fetch only new messages.\n"
source: https://flowdrop.io/docs/api/playground/listPlaygroundMessages
site: FlowDrop documentation
---
# Get messages from a playground session
`GET /playground/sessions/{sessionId}/messages`

Retrieve messages from a playground session with optional filtering.
Supports polling via the `since` parameter to fetch only new messages.

## Parameters

- `sessionId` · in path · string · required — Playground session UUID
- `since` · in query · integer — Sequence number cursor — returns only messages with sequenceNumber
greater than this value (forward pagination). Used for efficient
polling of the live conversation tail. Mutually exclusive with `before`.
- `before` · in query · integer — Sequence number cursor for backward pagination — returns the page of
messages with sequenceNumber LESS than this value, selecting the
`limit` messages with the highest sequence numbers below the cursor
(i.e. the page immediately older than the cursor). Used for
"load older" on scroll-up. Mutually exclusive with `since`.
- `latest` · in query · boolean — When true, return the most recent `limit` messages (the conversation
tail), ignoring `since` and `before`. Use for the initial load of a
chat surface. Defaults to false, which preserves the legacy
oldest-first behavior when no cursor is supplied.
- `limit` · in query · integer — Maximum number of messages to return

## Responses

- `200` — Messages retrieved successfully (`application/json`: PlaygroundMessagesResponse)
- `404` — Resource not found (`application/json`: ErrorResponse)
- `500` — Internal server error (`application/json`: ErrorResponse)

*Tags: Playground*