Lists messages that belong to a given conversation. messages are ordered by createTime in descending order. To fetch updates without duplication, send request with filter create_time_epoch_microseconds >
[first item's createTime of previous request] and empty pageToken.
HTTP request
GET https://{endpoint}/v2beta1/{parent=projects/*/locations/*/conversations/*}/messages
Required. The name of the conversation to list messages for. Format: projects/<Project ID>/locations/<Location
ID>/conversations/<Conversation ID>
Authorization requires the following IAM permission on the specified resource parent:
dialogflow.messages.list
Query parameters
Parameters
filter
string
Optional. Filter on message fields. Currently predicates on createTime and create_time_epoch_microseconds are supported. createTime only support milliseconds accuracy. E.g., create_time_epoch_microseconds > 1551790877964485 or createTime > "2017-01-15T01:30:15.01Z".
For more information about filtering, see API Filtering.
pageSize
integer
Optional. The maximum number of items to return in a single page. By default 100 and at most 1000.
pageToken
string
Optional. The nextPageToken value returned from a previous list request.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis page details how to list messages within a given conversation using the Dialogflow API's \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required and specifies the conversation to list messages from, using the format \u003ccode\u003eprojects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter messages based on their \u003ccode\u003ecreateTime\u003c/code\u003e or \u003ccode\u003ecreate_time_epoch_microseconds\u003c/code\u003e using the optional \u003ccode\u003efilter\u003c/code\u003e query parameter, allowing for filtering based on a time constraint.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for listing messages must be empty, and the response will contain a \u003ccode\u003eListMessagesResponse\u003c/code\u003e instance if successful.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, one of two OAuth scopes are required: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
