API reference

Find email

Find someone's work email by name and company domain.

POST/v1/find

Parameters

ParameterTypeDescription
first_namereq
stringPerson's first name.
last_namereq
stringPerson's last name.
domainreq
stringCompany domain (e.g. stripe.com).

Request

curl -X POST https://api.gtmcli.com/v1/find \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Patrick", "last_name": "Collison", "domain": "stripe.com"}'

Response

200 OKjson
{
  "email": "pc@stripe.com",
  "status": "valid",
  "convention": "flast",
  "confidence": 1,
  "provider": "other"
}

Response fields

ParameterTypeDescription
email
stringThe discovered email address. Empty if not found.
status
stringResult: valid, valid_catchall, catchall, not_found.
convention
stringThe naming pattern that matched (e.g. flast, first.last).
confidence
numberConfidence score from 0 to 1. 1.0 = verified by mail server.
provider
stringEmail provider if detected.

Status values

validEmail found and verified by the mail server.1 credit
valid_catchallBest guess on a catchall domain. Check confidence score.1 credit
catchallDomain accepts all emails. Generated a likely address but cannot verify.Free
not_foundCould not determine the email address.Free

INFO

The finder tries up to 16 naming conventions (first.last, flast, firstl, etc.) and verifies each one against the mail server in real time. It is not a database lookup.

Confidence scores

1.0Verified by mail server. The mailbox exists.
0.7-0.99High confidence. Known convention at this domain.
0.3-0.69Moderate. Catchall domain with convention match.
<0.3Low confidence guess.

Errors

400Missing required fields (first_name, last_name, domain).
401Missing or invalid API key.
402Insufficient credits.
429Rate limit exceeded.