Struggling to handle Direct Messages

[kahnbenjamina]

Hello!

I am currently writing a bot with the goal of pulling all messages sent to an account over a specific time period. The documentation regarding the Python handling of direct messages is pretty limited, but I've gotten to the point where I can get the most recent message sent in each convo like so:

dm_client = client.with_bsky_chat_proxy()
dm = dm_client.chat.bsky.convo

convo_list = dm.list_convos()

for convo in convo_list.convos:
    for val in convo.last_message:
        print(val)

Output:

('id', 'XXX')
('rev', 'XXX')
('sender', MessageViewSender(did='did:plc:XXX', py_type='chat.bsky.convo.defs#messageViewSender'))
('sent_at', '2026-01-25T00:09:15.996Z')
('text', 'This is a second test Direct Message.')
('embed', None)
('facets', None)
('reactions', [])
('py_type', 'chat.bsky.convo.defs#messageView')

However, in the event of someone sending more than one message in the given time period, I can't seem to figure out a way to retrieve all messages sent, not just the most recent one.

When I run the following code, I receive a list of variables including that last_message field, but seemingly no way of accessing messages prior to that.

for convo in convo_list.convos:
    for val in convo:
        print(val)

Output:

('muted', False)
('rev', 'XXX')
('unread_count', 2)
('last_message', MessageView(id='XXX', rev='XXX', sender=MessageViewSender(did='did:plc:XXX', py_type='chat.bsky.convo.defs#messageViewSender'), sent_at='2026-01-25T00:09:15.996Z', text='This is a second test Direct Message.', embed=None, facets=None, reactions=[], py_type='chat.bsky.convo.defs#messageView'))
('last_reaction', None)
('status', 'accepted')
('py_type', 'chat.bsky.convo.defs#convoView')

My question is if the functionality I'm describing is available/possible with the atproto API and if so, where would I find documentation about it? Thanks in advance for any help!

[MarshalX]

Hello! Get messages with cursor based pagination should solve your needs

All chat conversation models: https://atproto.blue/en/latest/atproto/atproto_client.models.chat.bsky.convo.html

Get messages params and response: https://atproto.blue/en/latest/atproto/atproto_client.models.chat.bsky.convo.get_messages.html

Get messages method in the namespace: https://atproto.blue/en/latest/atproto_client/namespace.html#atproto_client.namespaces.sync_ns.ChatBskyConvoNamespace.get_messages