Skip to main content
POST
Predict from an email

Authorizations

Authorization
string
header
required

Your Finowl API key, for example finowl_3f9a.... Create keys in the dashboard under API Keys.

Body

application/json
email
string<email>
required

The email address to analyze.

Maximum string length: 254
Example:

"alice.johnson@example.com"

country
string

Optional ISO 3166-1 alpha-2 country hint, such as US or TR. Improves accuracy for names whose gender varies by country.

Pattern: ^[A-Za-z]{2}$
Example:

"US"

forceToGenderize
boolean
default:false

Try to predict even when the input does not look like a name. Cannot be combined with ai_mode off or always.

options
object

Response

The prediction completed. An unknown result is still a successful response.

data
object
required

A gender estimate. result_status and gender are always present. Other fields, such as confidence and country, are included when available, and new fields may be added.