# GenderAPI.io V2 documentation

> Connect to GenderAPI.io V2 at api.genderapi.io. Predict from names, emails or usernames, process mixed batches and read results with access and billing metadata.

Canonical HTML: https://www.genderapi.io/api-documentation

Last reviewed: 2026-09-27

## 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.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Sophia&country=US&ai_mode=off
```

- [Open the GET example (uses 1 trial credit)](https://api.genderapi.io/api/v2/gender?type=name&value=Sophia&country=US&ai_mode=off)
- [Set up your API key](https://www.genderapi.io/docs/v2/authentication#environment-setup)
- [Understand the JSON response](https://www.genderapi.io/docs/v2/responses)

## What 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.

- [API key & free trial](https://www.genderapi.io/docs/v2/authentication): Connect your API key or try the API for free.
- [Request parameters](https://www.genderapi.io/docs/v2/request-parameters): Choose input fields, country context and request options.
- [Official SDKs](https://www.genderapi.io/docs/v2/sdks): Install an official client for your programming language.
- [Gender from name](https://www.genderapi.io/docs/v2/gender-from-name): Look up a first name or full name.
- [Gender from email](https://www.genderapi.io/docs/v2/gender-from-email): Find a name signal in an email address.
- [Gender from username](https://www.genderapi.io/docs/v2/gender-from-username): Use a username or nickname as input.
- [Bulk lookups (batch)](https://www.genderapi.io/docs/v2/batch): Process up to 50 names, emails or usernames at once.
- [Phone validation](https://www.genderapi.io/docs/v2/phone-validation): Check and format a phone number.
- [Read a response](https://www.genderapi.io/docs/v2/responses): Read predictions, confidence scores and unknown results.
- [AI & nicknames](https://www.genderapi.io/docs/v2/ai-options): Choose when to use AI and how to handle nicknames.
- [Credits & balance](https://www.genderapi.io/docs/v2/credits-and-usage): Check your balance and what each request costs.
- [Errors & retries](https://www.genderapi.io/docs/v2/errors-and-retries): Resolve errors and decide when to retry.
- [Migrate from v1](https://www.genderapi.io/docs/v2/migration): Update an existing integration using the same API key.

## 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. |