Skip to main content
POST
Predict from a name

Tips for better results

  • Send the full name when you have it. Finowl intelligence picks out the first name itself.
  • Add country when you know it. Names such as Andrea or Jean lean differently by country.
  • Handle unknown. result_status: "unknown" with gender: null is a normal, successful answer. Store it as unknown rather than guessing.

Reading predictions

How to use confidence, unknown results and AI modes responsibly.

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.