Skip to the documentation
CLI

openemail senders

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

Commands

What is known about the organisation behind a sender, the line the reading pane shows under an unfamiliar one, and looking a sender up.

Every command here also takes the global flags, such as --json, --profile and --dry-run. See the global flags

openemail senders get

Read what is known about a sender

Scopesthreads:readNeeds a sign-inAliasesshowview

Usage

openemail 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, and what is known is kept for the whole workspace.

A domain nobody has looked up yet is a 404. research looks it up.

Arguments

<email>Required

An address of the sender, such as [email protected].

Examples

openemail senders get [email protected]
Print the raw JSON
openemail senders get [email protected] --json

Also available in

API
GET /senders/{email}
SDK
senders.get()

openemail senders research

Look a sender up

Scopesthreads:readNeeds a sign-in

Usage

openemail senders research <email> [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.

Arguments

<email>Required

An address of the sender. Only its domain is looked up.

Examples

openemail senders research hello@acme-robotics.io
Print the raw JSON
openemail senders research hello@acme-robotics.io --json

Also available in

API
POST /senders/{email}/research
SDK
senders.research()