# GenderAPI v1 documentation

> Choose a documented GenderAPI endpoint and implement it from trusted server-side code.

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

Last reviewed: 2026-09-14

## Endpoints

| Workflow | Method | Path | Documentation |
| --- | --- | --- | --- |
| Infer gender from one name | POST | /api | https://www.genderapi.io/docs-gender-from-name-single |
| Infer gender from multiple names | POST | /api/name/multi/country | https://www.genderapi.io/docs-gender-from-name-multiple |
| Extract a name and infer gender from one email address | POST | /api/email | https://www.genderapi.io/docs-gender-from-email-single |
| Extract names and infer gender from multiple email addresses | POST | /api/email/multi/country | https://www.genderapi.io/docs-gender-from-email-multiple |
| Extract a name and infer gender from one username | POST | /api/username | https://www.genderapi.io/docs-gender-from-username-single |
| Extract names and infer gender from multiple usernames | POST | /api/username/multi/country | https://www.genderapi.io/docs-gender-from-username-multiple |
| Retrieve remaining quota and expiration | GET | /api/remaining | https://www.genderapi.io/docs-usage-and-quota |
| Validate and format a phone number | POST | /api/phone | https://www.genderapi.io/docs-phone-validation-formatter-api |

## Implementation rules

- Use Bearer authentication for POST requests.
- Preserve null and probability results.
- Use country context only when reliable.
- Branch on errno and do not retry permanent failures unchanged.

- [OpenAPI JSON](https://www.genderapi.io/openapi/openapi.json)