--- title: "openemail senders" description: "Every command in this namespace, with its arguments, flags and examples." url: "https://openemail.uk/docs/cli/reference/senders" area: "CLI" category: "Reference" --- # openemail senders Every command in this namespace, with its arguments, flags and examples. ## Commands ### `openemail senders get` Read what is known about a sender ```bash openemail senders get [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, and what is known is kept for the whole workspace. A domain nobody has looked up yet is a 404. `research` looks it up. - Scopes: `threads:read`. - Needs a sign-in. - Aliases: `show`, `view`. **Arguments** - `` (required): An address of the sender, such as `billing@stripe.com`. **Examples** ```bash openemail senders get billing@stripe.com ``` Print the raw JSON ```bash openemail senders get billing@stripe.com --json ``` Also available in: API [`GET /senders/{email}`](https://openemail.uk/docs/api/reference/senders#get-senders-email); SDK [`senders.get()`](https://openemail.uk/docs/sdk/reference/senders#get). ### `openemail senders research` Look a sender up ```bash openemail senders research [flags] ``` Searches the web for the organisation behind the domain of an address and keeps what it found for the whole workspace, as the reading pane does the first time it shows a sender. A domain that was looked up before is answered from what was kept, and nothing is searched again. 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 senders a day, and the next one is a 429 `research_limit_reached`. A domain nothing could be found about is a 404. - Scopes: `threads:read`. - Needs a sign-in. **Arguments** - `` (required): An address of the sender. Only its domain is looked up. **Examples** ```bash openemail senders research hello@acme-robotics.io ``` Print the raw JSON ```bash openemail senders research hello@acme-robotics.io --json ``` Also available in: API [`POST /senders/{email}/research`](https://openemail.uk/docs/api/reference/senders#post-senders-email-research); SDK [`senders.research()`](https://openemail.uk/docs/sdk/reference/senders#research).