Make your first request
Use GenderAPI.io V2 to estimate gender from a first or full name, email address or username. The API origin is https://api.genderapi.io and the V2 base path is /api/v2. Try the GET example below in your browser, then choose a guide to connect your application.
The free trial includes 10 credits per IP address per 24 hours, shared with v1. This dataset-only example costs 1 credit per request, including each refresh. When you connect your existing API key, v1 and v2 use the same account balance.
https://api.genderapi.io/api/v2/gender?type=name&value=Sophia&country=US&ai_mode=offWhat would you like to do?
Choose your input type for working examples in cURL, JavaScript, Python, PHP, Java, C# and Go. Use the result and billing guides when you are ready to handle real responses.
Get started
Send requests
Understand results & costs
Endpoint reference
Combine https://api.genderapi.io with the absolute paths in this table. For example: https://api.genderapi.io/api/v2/gender. Query parameters are supported only on GET /gender. Use JSON bodies for POST routes; do not send v1 fields such as name, email, username or askToAI in a v2 request.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v2 | Public capabilities and current limits; free. |
| GET | /api/v2/openapi.json | Canonical OpenAPI contract; free. |
| GET | /api/v2/errors | Machine-readable error catalog; free. |
| GET | /api/v2/usage | Current account or trial balance; free. |
| GET / POST | /api/v2/gender | One name, email address or username. |
| POST | /api/v2/gender/batch | An ordered batch of names, emails and/or usernames. |
| POST | /api/v2/phone/validate | Validate and format a phone number. |