Skip to main content
GET
/
sessions
/
{session_id}
/
messages
List Session Messages
const options = {method: 'GET', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v3/sessions/{session_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "messages": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "role": "<string>",
      "data": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "type": "",
      "summary": "",
      "screenshotUrl": "<string>",
      "hidden": false
    }
  ],
  "hasMore": true
}

Authorizations

​
X-Browser-Use-API-Key
string
header
required

Path Parameters

​
session_id
string<uuid>
required

Query Parameters

​
after
string<uuid> | null

Cursor: return messages after this message ID

​
before
string<uuid> | null

Cursor: return messages before this message ID

​
limit
integer
default:10

Maximum number of messages to return (max 100).

Required range: 1 <= x <= 100

Response

Successful Response

​
messages
MessageResponse · object[]
required

List of messages in chronological order.

​
hasMore
boolean
required

Whether there are more messages available beyond this page. Use cursor-based pagination with the after or before query parameters to fetch more.