API reference

Statuses

GTMCLI returns specific status values for validation and finder results. Understanding these statuses helps you decide how to handle each result.

Validation Statuses

Returned by /v1/validate:

StatusDescriptionCharged?

validThe email exists and is deliverable. SMTP server confirmed the mailbox.0.25 credits

invalidThe email does not exist. SMTP server rejected the recipient.Free

catchallThe domain accepts all emails. Cannot confirm if this specific mailbox exists.Free

valid_catchallCatch-all domain, but additional signals suggest this specific email is real.Free

disposableThe email uses a temporary/disposable email provider.Free

riskyThe email may exist but shows signs of risk (e.g. full inbox, greylisting).Free

Finder Statuses

Returned by /v1/find:

StatusDescriptionCharged?

validA verified email was found. SMTP confirmed the mailbox exists.1 credit

valid_catchallFound on a catch-all domain with high confidence the email is real.1 credit

catchallBest guess on a catch-all domain. Convention matching suggests this pattern, but cannot confirm.Free

not_foundNo email could be found for this person at the given domain.Free

NOTE

Finder results with catchall status are our best guess based on naming conventions but are not SMTP-verified. Use them with caution in outbound campaigns.

Provider Values

The provider field indicates the email hosting provider detected for the domain:

ProviderDescription

googleGoogle Workspace (Gmail for business)

microsoftMicrosoft 365 / Exchange Online

otherAll other email providers (self-hosted, Zoho, Fastmail, etc.)

Billing Summary

TIP

Only valid results from validation (0.25 credits) and valid or valid_catchall results from finder (1 credit) are charged. Everything else is free.