# hunter.email.verify

Valid or deliverable status and score of one email address

> This API endpoint allows you to verify the deliverability of an email address.

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

| Field | Value |
| --- | --- |
| provider | [Hunter](https://telipot.com/catalog/providers/hunter) `hunter` |
| capability | [`email.verify`](https://telipot.com/catalog/capabilities/email.verify) |
| kind | data |
| tier | core |
| price | $0.0123 / verification (0.5 credits · docs) |
| price note | All-in-one plans: 0.5 credit per verified email; nothing when Hunter fails to verify (status unknown) or the address is disposable, and a repeat in one billing period is not charged again. Data Platform plans: 1 Verification credit. A 202 means the verification is still running: repeat the same call, it counts once. |
| 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-verifier` |
| 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-verifier |

## Preview the price · nothing runs

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

## Run it

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

```bash
curl https://api.telipot.com/v1/tasks/hunter.email.verify/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 verify. |
| `domain_metadata` | queryParams | string | no |  | Any non-empty value adds meta.domain, company_name, following_domain and webmail about the address's domain. Listed in Hunter's OpenAPI, not on the docs page. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to verify.",
      "examples": [
        "someone@example.com"
      ]
    },
    "domain_metadata": {
      "type": "string",
      "description": "Any non-empty value adds meta.domain, company_name, following_domain and webmail about the address's domain. Listed in Hunter's OpenAPI, not on the docs page.",
      "examples": [
        "1"
      ]
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "meta"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "description": "valid, invalid, accept_all, webmail, disposable or unknown"
        },
        "score": {
          "type": "integer"
        },
        "email": {
          "type": "string"
        },
        "regexp": {
          "type": "boolean"
        },
        "gibberish": {
          "type": "boolean"
        },
        "disposable": {
          "type": "boolean"
        },
        "webmail": {
          "type": "boolean"
        },
        "mx_records": {
          "type": "boolean"
        },
        "smtp_server": {
          "type": "boolean"
        },
        "smtp_check": {
          "type": "boolean"
        },
        "accept_all": {
          "type": "boolean"
        },
        "block": {
          "type": "boolean"
        },
        "result": {
          "type": "string",
          "description": "Deprecated; use status"
        },
        "verification": {
          "type": "object",
          "properties": {
            "date": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "domain": {
                "type": "string"
              },
              "uri": {
                "type": "string"
              },
              "extracted_on": {
                "type": "string"
              },
              "last_seen_on": {
                "type": "string"
              },
              "still_on_page": {
                "type": "boolean"
              }
            }
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "required": [
        "params"
      ],
      "properties": {
        "params": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string"
            }
          }
        },
        "message": {
          "type": "string",
          "description": "Present on a 202, while the verification is still running"
        }
      }
    }
  }
}
```