Email Intelligence

curl --request POST \
  --url https://api.enricho.co/api/directory/email/intelligence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "jane@company.com",
    "sam@example.org"
  ],
  "checks": [
    "compliance",
    "validity"
  ]
}
'

{
  "success": true,
  "result": {
    "results": [
      {
        "email": "<string>",
        "valid": true,
        "reason": "<string>",
        "compliance": {
          "recipient_type": "business",
          "verdict": "allowed",
          "reason": "<string>",
          "conditions": [
            "<string>"
          ],
          "exceptions": [
            "<string>"
          ],
          "sources": [
            "<string>"
          ],
          "country_code": "<string>",
          "country_source": "person_record",
          "country_confidence": "high",
          "law": "<string>"
        },
        "gender": {
          "gender": "male",
          "probability": 123,
          "source": "person_record",
          "first_name": "<string>"
        },
        "validity": {
          "status": "valid",
          "reason": "<string>",
          "domain_accepts_mail": true,
          "disposable": true,
          "role_address": true,
          "free_provider": true,
          "mailbox": "not_checked"
        },
        "identity": {
          "found": true,
          "match": "email",
          "person_id": "<string>",
          "full_name": "<string>",
          "job_title": "<string>",
          "seniority": "<string>",
          "linkedin_url": "<string>",
          "city": "<string>",
          "country_code": "<string>",
          "company": {
            "company_id": "<string>",
            "name": "<string>",
            "domain": "<string>",
            "industry": "<string>",
            "employee_size_band": "<string>",
            "linkedin_url": "<string>",
            "country_code": "<string>"
          }
        },
        "breaches": {
          "status": "ok",
          "breached": true,
          "count": 123,
          "breaches": [
            {
              "name": "<string>",
              "title": "<string>",
              "data_classes": [
                "<string>"
              ],
              "verified": true,
              "domain": "<string>",
              "breach_date": "2023-12-25"
            }
          ],
          "source": "Have I Been Pwned"
        }
      }
    ],
    "checks": [
      "<string>"
    ],
    "credits_used": 123,
    "already_purchased": 123,
    "rules_version": "<string>",
    "disclaimer": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

POST

api

directory

intelligence

curl --request POST \
  --url https://api.enricho.co/api/directory/email/intelligence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "jane@company.com",
    "sam@example.org"
  ],
  "checks": [
    "compliance",
    "validity"
  ]
}
'

{
  "success": true,
  "result": {
    "results": [
      {
        "email": "<string>",
        "valid": true,
        "reason": "<string>",
        "compliance": {
          "recipient_type": "business",
          "verdict": "allowed",
          "reason": "<string>",
          "conditions": [
            "<string>"
          ],
          "exceptions": [
            "<string>"
          ],
          "sources": [
            "<string>"
          ],
          "country_code": "<string>",
          "country_source": "person_record",
          "country_confidence": "high",
          "law": "<string>"
        },
        "gender": {
          "gender": "male",
          "probability": 123,
          "source": "person_record",
          "first_name": "<string>"
        },
        "validity": {
          "status": "valid",
          "reason": "<string>",
          "domain_accepts_mail": true,
          "disposable": true,
          "role_address": true,
          "free_provider": true,
          "mailbox": "not_checked"
        },
        "identity": {
          "found": true,
          "match": "email",
          "person_id": "<string>",
          "full_name": "<string>",
          "job_title": "<string>",
          "seniority": "<string>",
          "linkedin_url": "<string>",
          "city": "<string>",
          "country_code": "<string>",
          "company": {
            "company_id": "<string>",
            "name": "<string>",
            "domain": "<string>",
            "industry": "<string>",
            "employee_size_band": "<string>",
            "linkedin_url": "<string>",
            "country_code": "<string>"
          }
        },
        "breaches": {
          "status": "ok",
          "breached": true,
          "count": 123,
          "breaches": [
            {
              "name": "<string>",
              "title": "<string>",
              "data_classes": [
                "<string>"
              ],
              "verified": true,
              "domain": "<string>",
              "breach_date": "2023-12-25"
            }
          ],
          "source": "Have I Been Pwned"
        }
      }
    ],
    "checks": [
      "<string>"
    ],
    "credits_used": 123,
    "already_purchased": 123,
    "rules_version": "<string>",
    "disclaimer": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

{
  "success": false,
  "result": {
    "code": "<string>"
  },
  "message": "<string>"
}

Send the addresses in emails and the checks to run in checks. Each result has a section for every check you asked for.

curl -X POST 'https://api.enricho.co/api/directory/email/intelligence' \
  -H 'Authorization: Bearer enr_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"emails":["jane@company.com","sam@example.org"],"checks":["compliance","validity"]}'

Checks

Check	What it answers
`compliance`	The recipient’s country and whether a cold email to them is allowed there, with the law, the conditions to meet and any exceptions.
`gender`	From the person’s record when Enricho holds it, otherwise inferred from the name in the address (`source: "name_inference"`), with how sure it is.
`validity`	Valid format, whether the domain receives mail, and whether it’s a throwaway or shared inbox (`info@`). The mailbox itself isn’t probed yet (`mailbox: "not_checked"`).
`identity`	Who the address belongs to and their company: name, job title, LinkedIn and location, and the company’s industry, size and head office. From Enricho’s records, else LinkedIn.
`breaches`	The data breaches the address appears in, from Have I Been Pwned. Sensitive breaches are never included.

Up to 100 checks per request, counting addresses × checks: 100 addresses with one check, or 20 addresses with all five.

Identity

match says how the person was found:

`match`	Meaning
`email`	Enricho’s record of the person holds this exact address.
`name_at_company`	Someone with the name in the address (`anna.schmidt@`) works at the domain’s company. A likely match: the address itself isn’t confirmed as theirs.

When the person isn’t found, company can still describe the company behind the domain. Identity is charged when either is found.

Compliance

The recipient’s country is found in this order:

`country_source`	`country_confidence`	Meaning
`person_record`	`high`	The address belongs to a person in Enricho, and their location is known.
`name_match`	`medium`	Someone with the name in the address (like `anna.schmidt@`) works at the domain’s company: where they are.
`company_hq`	`medium`	The head office country of the domain’s company. The person may work elsewhere.
`domain_tld`	`low`	The domain’s country ending. Endings used worldwide (`.io`, `.co`, `.ai`…) are ignored.

`verdict`	Meaning
`allowed`	A cold email is allowed without prior consent if you meet every item in `conditions`.
`consent_required`	You need the recipient’s prior consent, unless one of the `exceptions` applies to you.
`do_not_send`	A throwaway inbox or a domain that takes no mail.
`unknown`	No country found, or no rules for that country yet.

Most laws treat a company address differently from a personal mailbox, so recipient_type (business or personal) changes the verdict. Where a law’s position on business email is unclear, the stricter answer is returned.

Compliance is a summary of each country’s cold-email rules, not legal advice. rules_version names the rules that answered; check with counsel before relying on a verdict.

Credits

Each check on each address costs 5 credits, and only when it has an answer. These are free:

an unknown gender or compliance country, and an identity where neither the person nor the company is found
a breach lookup that didn’t answer in time (status: "unavailable")
addresses that aren’t valid
any check you ran on the same address in the last year (counted in already_purchased)

Authorizations

Authorization

string

header

required

Enricho API key (enr_...)

Body

application/json

Send JSON with Content-Type: application/json.

emails

required

One address, or a list of up to 100. Duplicates are checked once.

Maximum string length: 200

checks

required

The checks to run on every address.

Available options:

compliance,

gender,

validity,

identity,

breaches

Response

Success envelope.

success

boolean

required

result

object

required

Show child attributes

message

string

required

Essentials

Directory

Jobs

Gigs

Profiles

Email

Billing and usage

Email Intelligence

Checks

Identity

Compliance

Credits

Authorizations

Body

Response

​Checks

​Identity

​Compliance

​Credits

Authorizations

Body

Response

Checks

Identity

Compliance

Credits