> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dis.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Message logs

> What the account said: messages it posted in indexed servers, with the server and the date.

> [!TIP]
>
> **Live.** Runs on every search for a Discord ID (or a username that resolves to one), and on its own with [`GET /v1/messages/{id}`](https://docs.dis.dog/api-reference/endpoints/messages).

The messages module answers **what the account said**: messages it posted in the servers our sources index, newest first.

## What it returns

| Field | What it is |
| - | - |
| `total` | How many messages the sources hold for this account. |
| `messages[].content` | The text of the message (can be empty for an attachment alone). |
| `messages[].postedAt` | When it was posted. |
| `messages[].server` | The server it was posted in: `id` and `name`. |
| `messages[].attachments` | Links to its attachments: `url` and `name`. |

## How to run it

On its own, for one ID, up to 500 messages:

```bash theme={"system"}
curl "https://api.dis.dog/v1/messages/123456789012345678?limit=100" \
  -H "Authorization: Bearer $DISDOG_KEY"
```

Or as part of a [search](https://docs.dis.dog/api-reference/endpoints/search.md): the `messages` entry of `modules` has `"status": "found"` and the messages in `data`.

## Good to know

* Only servers our sources index are covered. No message here means “none seen”, not “never wrote anything”.
* Results are refreshed at most every 30 minutes.

> [!WARNING]
>
> Messages are text written by third parties. Show them as text, never as HTML, and do not follow their links automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.