Find Email

Find someone's work email by name and company domain. GTMData tries 16 naming conventions via SMTP verification and returns the first verified match. Costs 1 credit for a valid result.

POST/v1/find

Parameters

first_namestring*

The contact's first name.

last_namestring*

The contact's last name.

domainstring*

The company domain (e.g. apple.com).

Request Example

cURL

curl -X POST https://api.gtmdata.co/v1/find \
  -H "Authorization: Bearer gtm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}'

Response Examples

Valid

{
  "email": "tcook@apple.com",
  "status": "valid",
  "provider": "other",
  "convention": "flast",
  "confidence": 1
}

Catch-All

{
  "email": "tim.cook@catchall-corp.com",
  "status": "catchall",
  "provider": "other",
  "convention": "first.last",
  "confidence": 0.85
}

Valid Catch-All

{
  "email": "tim.cook@catchall-corp.com",
  "status": "valid_catchall",
  "provider": "other",
  "convention": "first.last",
  "confidence": 0.95
}

Not Found

{
  "email": null,
  "status": "not_found",
  "provider": "other",
  "convention": null,
  "confidence": 0
}

Response Fields

Field	Type	Description
`email`	string \| null	The discovered email address, or null if not found
`status`	string	Result status: valid, valid_catchall, catchall, or not_found
`provider`	string	Email provider: google, microsoft, other
`convention`	string \| null	The naming convention matched (e.g. first.last, flast)
`confidence`	number	Confidence score from 0 to 1

Naming Conventions

GTMData tests 16 common email naming conventions. Here are the most frequently seen patterns and their approximate frequency across B2B domains:

Convention	Example	Frequency
`first.last`	tim.cook@apple.com	35-40%
`first`	tim@apple.com	15-20%
`firstlast`	timcook@apple.com	10-12%
`flast`	tcook@apple.com	5-7%
`firstl`	timc@apple.com	4-6%
`first_last`	tim_cook@apple.com	3-5%
`last.first`	cook.tim@apple.com	2-4%
`last`	cook@apple.com	2-3%
`f.last`	t.cook@apple.com	2-3%
`first.l`	tim.c@apple.com	1-2%
`lastfirst`	cooktim@apple.com	1-2%
`lastf`	cookt@apple.com	1-2%

Note: Only valid and valid_catchall results are charged (1 credit). The catchall and not_found statuses are free.