# hunter.email.insight

Disposable, webmail and mail-server flags of an email

> Returns deliverability signals for a single email address without a full verification.

Page: https://telipot.com/catalog/tasks/hunter.email.insight · Markdown: https://telipot.com/catalog/tasks/hunter.email.insight/md · JSON: https://telipot.com/catalog/tasks/hunter.email.insight/json

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`email.insight`](https://telipot.com/catalog/capabilities/email.insight) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Your plan |
| auth | `api_key · in header as X-API-KEY` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.hunter.io/v2/email-insight` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://hunter.io/api-documentation/v2#email-insight |

## Preview the price · nothing runs

```bash
telipot run hunter.email.insight \
  --input-json '{"email":"test@example.com"}' \
  --quote
```

## Run it

```bash
telipot run hunter.email.insight \
  --input-json '{"email":"test@example.com"}'
```

```bash
curl https://api.telipot.com/v1/tasks/hunter.email.insight/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `email` | queryParams | string | yes |  | The email address to inspect. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to inspect.",
      "examples": [
        "someone@example.com"
      ]
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string"
        },
        "gibberish": {
          "type": "boolean",
          "description": "True when the local part looks like a random string"
        },
        "pattern": {
          "type": "boolean",
          "description": "True when Hunter has detected a recognized email pattern for the domain"
        },
        "mx_records": {
          "type": "boolean",
          "description": "True when the domain can receive email"
        },
        "disposable": {
          "type": "boolean"
        },
        "webmail": {
          "type": "boolean"
        },
        "webmail_allowed": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Reserved; currently always null"
        }
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "params": {
          "type": "object"
        }
      }
    }
  }
}
```