> ## 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.

# Server memberships

> The servers the account has been seen in, with their size and when the account was last seen there.

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

The servers module answers **where the account hangs out**: the Discord servers it has been seen in, from an index of server member lists.

## What it returns

| Field | What it is |
| - | - |
| `total` | How many servers the account has been seen in. |
| `servers[].id`, `name` | The server’s ID and name. |
| `servers[].iconUrl` | The server icon, or `null`. |
| `servers[].memberCount` | The server’s size when it was last indexed. |
| `servers[].lastSeenAt` | The last time the account was seen in that server. |

Servers are sorted by size, largest first.

## How to run it

On its own, for one ID:

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

Or as part of a [search](https://docs.dis.dog/api-reference/endpoints/search.md): the `servers` entry of `modules` has `"status": "found"` and the same object in `data`, or `"not_found"` when the account hasn’t been seen anywhere.

## Good to know

* The index only covers servers it has been able to read. An empty list means “not seen”, not “in no server”.
* Lists are refreshed at most every 30 minutes.
* Nicknames, roles and join dates per server aren’t available yet.

> [!WARNING]
>
> Server names are text written by third parties. Show them as text, never as HTML.


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