Skip to main content

Features

Country hint enrichment

Get a country-level hint from an email address's domain, and what that hint can and cannot tell you.

Country hint data

Country hints are based on domain-level signals such as country-code TLDs and known provider countries:

  • Country
  • Country code

How it works

We infer only a country-level domain hint. We do not infer a contact's city, region, postal code, timezone, title, company, or LinkedIn profile.

The hint describes the domain, not the person. An address at a free mail provider gets the provider's country (gmail.com, outlook.com and yahoo.com read as the United States), and an address at a large company's domain gets the country of its head office. Do not use it to decide where someone lives or which privacy law applies to them.

Which plans include it

Country hints are part of data enrichment, which is included on the Business plan and above. To get them, add enrich: true to the options of your API verification request (the dashboard has no setting for it). On a lower plan, a request that sends enrich: true is refused as a whole with 403 PLAN_UPGRADE_REQUIRED, so nothing is verified and no credits are charged.

Response example

{
  "success": true,
  "data": {
    "email": "contact@example.de",
    "enrichment": {
      "country": "Germany",
      "country_code": "DE"
    }
  }
}

Use cases

  • Country-level campaign segmentation
  • Localized content checks before outreach

Something wrong or missing here?

Tell us what to fix. Your email goes to the support team with this article's title already filled in.

Send feedback

Still need help?

Email support@kawaa.com. If your question is about a bulk job, include its job ID from the dashboard.

Contact support