List chats
messenger_get_chats_v2Read-onlyIdempotent
Retrieve a list of your Avito chats with a preview of the last message and unread count. Filter by item, type, or unread status, and paginate results.
Instructions
Returns a LIST of the account's chats (conversations with buyers) with a preview of the last message and an unread counter. Read-only — sends nothing and does not mark anything as read. Use it to find the needed chat_id before messenger_get_messages_v3, messenger_post_send_message or messenger_chat_read. To get the details of a single known chat, use messenger_get_chat_by_id_v2. Supports filters (items, types, unread) and offset-based pagination via limit/offset.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_ids | No | Filter: CSV list of item IDs, returns chats for these items only (e.g. "12345,6789"). Defaults to all chats. | |
| limit | No | How many chats to return per page (1–100, default 100). | |
| offset | No | Pagination offset: skip N chats (default 0). | |
| unread_only | No | true — return only chats with unread messages; false/omitted — all chats. | |
| chat_types | No | Filter by chat type, CSV: u2i (conversation about an item), u2u (conversation between users). Defaults to all types. | |
| user_id | No | Avito account ID whose chats are requested. Defaults to Profile_id from .env. |