---
title: "nextmail senders"
description: "Every command in this namespace, with its arguments, flags and examples."
url: "https://nextmail.sh/docs/cli/reference/senders"
area: "CLI"
category: "Reference"
---

# nextmail senders

Every command in this namespace, with its arguments, flags and examples.

## Commands

### `nextmail senders get`

Read what is known about a sender

```bash
nextmail senders get <email> [flags]
```

Resolves a sentence or two about the organisation behind the domain of an address, the line the reading pane shows under an unfamiliar sender. Only the domain is read, so any address on it gives the same answer, a subdomain such as `mail.stripe.com` included, and `domain` names the organisation's own domain. What is known is shared by every workspace and looked up again by itself once it is 30 days old.

A domain nobody has looked up yet is a 404, and so are personal mailbox providers such as Gmail and the domains of your own workspace. `research` looks a domain up.

- Scopes: `threads:read`.
- Needs a sign-in.
- Aliases: `show`, `view`.

**Arguments**

- `<email>` (required): An address of the sender, such as `billing@stripe.com`.

**Examples**

```bash
nextmail senders get billing@stripe.com
```

Print the raw JSON

```bash
nextmail senders get billing@stripe.com --json
```

Also available in: API [`GET /senders/{email}`](https://nextmail.sh/docs/api/reference/senders#get-senders-email); TypeScript [`nextmail.senders.get()`](https://nextmail.sh/docs/sdk/reference/senders#get); Python [`senders.get()`](https://nextmail.sh/docs/python/reference/senders#get); Ruby [`senders.get`](https://nextmail.sh/docs/ruby/reference/senders#get); PHP [`senders->get`](https://nextmail.sh/docs/php/reference/senders#get); Go [`Senders.Get`](https://nextmail.sh/docs/go/reference/senders#get); Java [`senders().get`](https://nextmail.sh/docs/java/reference/senders#get); C# [`Senders.GetAsync`](https://nextmail.sh/docs/csharp/reference/senders#get).

### `nextmail senders research`

Look a sender up

```bash
nextmail senders research <email> [flags]
```

Searches the web for the organisation behind the domain of an address and keeps what it found, as the reading pane does the first time it shows a sender. Every address under the domain shares the answer, a subdomain such as `mail.stripe.com` included, and it is kept for 30 days before it is looked up again, so a domain that was looked up before is answered from what was kept and nothing is searched. Personal mailbox providers such as Gmail and the domains of your own workspace are never looked up.

Only the owner of the workspace may look senders up, with a key or an app that is not limited to particular addresses or domains: anything else is a 422 `capability_unsupported` or a 403 `owner_only`. A workspace looks up at most 200 new domains a day, and the next one is a 429 `research_limit_reached`. A domain nothing could be found about, a personal mailbox provider and a domain of your own workspace are a 404.

- Scopes: `threads:read`.
- Needs a sign-in.

**Arguments**

- `<email>` (required): An address of the sender. Only its domain is looked up.

**Examples**

```bash
nextmail senders research hello@acme-robotics.io
```

Print the raw JSON

```bash
nextmail senders research hello@acme-robotics.io --json
```

Also available in: API [`POST /senders/{email}/research`](https://nextmail.sh/docs/api/reference/senders#post-senders-email-research); TypeScript [`nextmail.senders.research()`](https://nextmail.sh/docs/sdk/reference/senders#research); Python [`senders.research()`](https://nextmail.sh/docs/python/reference/senders#research); Ruby [`senders.research`](https://nextmail.sh/docs/ruby/reference/senders#research); PHP [`senders->research`](https://nextmail.sh/docs/php/reference/senders#research); Go [`Senders.Research`](https://nextmail.sh/docs/go/reference/senders#research); Java [`senders().research`](https://nextmail.sh/docs/java/reference/senders#research); C# [`Senders.ResearchAsync`](https://nextmail.sh/docs/csharp/reference/senders#research).