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

# Terminology

```json theme={null}
{
  "email": "hello@usebouncer.com",
  "status": "deliverable",
  "reason": "accepted_email",
  "domain": {
    "name": "usebouncer.com",
    "acceptAll": "no",
    "disposable": "no",
    "free": "no"
  },
  "account": {
    "role": "yes",
    "disabled": "no",
    "fullMailbox": "no"
  },
  "dns": {
    "type": "MX",
    "record": "aspmx.l.google.com."
  },
  "provider": "google.com",
  "score": 100,
  "toxic": "unknown",
  "toxicity": 0
}
```

## Statuses

Every email address that you verify, will come back with a result that is either 'deliverable', 'undeliverable', 'risky' or 'unknown'. Below is a short explanation of what each means:

* `deliverable` - The recipient's email provider has confirmed that the email address exists, it is safe to send.
* `risky` - The email address may result in a bounce or low engagement. Risky addresses: Accept All, Full Mailbox or Disposable.
* `undeliverable` - The address is either syntactically incorrect or does not exist.
* `unknown` - We were unable to receive a response from the email provider.

## Reasons

Additionally to the status of your results, Bouncer will provide you with a reason for the results:

### risky

* `low_deliverability` - Email address appears to be deliverable, but deliverability cannot be guaranteed (in most cases it is caused by catch\_all / accept\_all configuration of recipient’s server or full mailbox).
* `low_quality` - Email address has quality issues that may make it a risky or low-value address (in most cases it is caused by the fact that it is a disposable/temporary email).

### undeliverable

* `invalid_email` - Specified email doesn't have a valid email address syntax.
* `invalid_domain` - Domain for email does not exist or has no valid DNS records.
* `rejected_email` - Email address was rejected by the SMTP server, email address does not exist.

### unknown

* `dns_error` - We were unable to resolve DNS records or domain is misconfigured.
* `unavailable_smtp` - SMTP server was unavailable to process our request.
* `unsupported` - Email hosted by an unsupported email service provider.
* `timeout` - Verification required more time than was available.
* `unknown` - An unexpected error has occurred.

## Domain

Bouncer also provides some information about the domain of the email address:

### name

Domain of the email.

## acceptAll

Is domain configured to accept all emails?

* `yes` - Domain of the email address is configured to accept all /catch all the emails.
* `no` - Domain of the email address does not accept all emails.
* `unknown` - Bouncer was unable to check if the domain of the email address is configured to accept all / catch all the emails.

### disposable

Is domain known disposable / temporary email provider?

* `yes` - Email address is hosted by a known disposable / temporary email provider.
* `no` - Email address is not hosted by a known disposable / temporary email provider.
* `unknown` - Bouncer was unable to check if the email is a deposable / temporary email address.

### free

Is domain known free email provider?

* `yes` - Email address is hosted by a known free email provider.
* `no` - Email address is not hosted by a known free email provider.
* `unknown` - Bouncer was unable to check if the email is a free email address.

## Account

Bouncer also provides some information about the email account itself:

### role

Is the email address a role / functional one (like support, hello, etc.)?

* `yes` - Email address is associated with a function.
* `no` - Email address is not associated with a function.
* `unknown` - Bouncer was unable to check if the email address is a role / functional one.

### disabled

Is the account disabled?

* `yes` - Account is disabled.
* `no` - Account is not disabled.
* `unknown` - Bouncer was unable to check if the account is disabled.

### fullMailbox

Is the mailbox full?

* `yes` - Mailbox is full.
* `no` - Mailbox is not full.
* `unknown` - Bouncer was unable to check if the mailbox is full.

## Provider

Name of infrastructure provider which handles SMTP communication for this domain.
It can be either an email service provider or a name of an anti-spam filter provider which protects underlying infrastructure.

## DNS

* type: `MX` - domain does have MX records configured
* type: `A` - only A records were found
* `record` - dns record used for verification

## Did You Mean

If the email address you have provided seems to be undeliverable or of low quality - Bouncer may find a suggestion of a correct one and return it in the didYouMean field.

Please note it was not fully verified, so you might want to run a verification of the suggested email address.

## Score

Score represents chance for successful delivery of email. 100 means 100% chance of delivery, given sending infrastructure has good reputation.

Empty value means that it wouldn't make sense to evaluate score, for example in the case of timeout.