Skip to main content
POST
Predict from a name

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

A first name or full name.

Required string length: 1 - 1024
Example:

"James Smith"

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.