Copy page

Response reference

Email format response

Returned by GET /email-format at data: the formats that a domain's email addresses follow, with the share of known addresses that use each one. The same pattern syntax is used by the pattern field of company and person responses.

Fields

data holds up to 20 formats, in no particular order; sort by percentage to find the most common. It's an empty array when Tomba has no formats for the domain.

Patterns

A pattern combines these tokens, either joined directly or separated by ., _, or -:

For example, {first}.{last} gives jane.doe, {f}{last} gives jdoe, and {last}_{f} gives doe_j.

Example

GET /email-format?domain=stripe.com:

Code
{
    "data": [
        { "format": "{first}", "percentage": 66 },
        { "format": "{first}.{last}", "percentage": 34 }
    ]
}