CHATHISTORY

The CHATHISTORY command is used to retrieve channel message history.

Retrieving Channel History

The CHATHISTORY command has two main forms:

Retrieving History by Timestamp or Message ID

Usage: CHATHISTORY <subcommand> <target> <timestamp | msgid | *> [<timestamp | msgid>] <limit>
<subcommand> The history retrieval subcommand. Valid subcommands are:

• BEFORE: Retrieve messages before the specified timestamp or message ID.
• AFTER: Retrieve messages after the specified timestamp or message ID.
• LATEST: Retrieve the latest messages. If a timestamp or message ID is given, only messages sent after and excluding that timestamp or message ID are returned. If * is given, no restriction is applied.
• AROUND: Retrieve messages around the specified timestamp or message ID. Requires one timestamp or message ID parameter.
• BETWEEN: Retrieve messages between the two specified timestamps or message IDs. Requires two timestamp or message ID parameters.

<target> The channel or nickname to retrieve history from.
<timestamp | msgid | *> A timestamp (in milliseconds since the epoch), a message ID, or * for no restriction with LATEST.
<limit> The maximum number of messages to retrieve.

Retrieving Available Targets

Usage: CHATHISTORY TARGETS <timestamp> <timestamp> <limit>
<timestamp> A timestamp (in milliseconds since the epoch).
<limit> The maximum number of targets to retrieve.

(See section chathistory Extension of IRCv3)