> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GenderAPI.io

> GenderAPI.io provides an API to determine the gender associated with a given name, email address, or username.

![GenderAPI.io logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/genderapi_io.png?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=02e34752d57930493df07251508c6e7b)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `GENDERAPI_IO`
* **Version:** 20261101\_00

## Tools

> [accordion] Gender API Get Statistics
>
> **Slug:** `GENDERAPI_IO_GENDERAPI_GET_STATS`
>
> Tool to retrieve account usage statistics from GenderAPI.io. Use when you need to check remaining API credits and expiry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Gender by First Name
>
> **Slug:** `GENDERAPI_IO_GENDER_API_QUERY_BY_FIRST_NAME`
>
> Tool to determine gender by querying first name. Use when you need to infer likely gender for a given name with optional localization hints.
>
> #### Input Parameters
>
> **id** `string`
>
> Optional arbitrary identifier (up to 50 characters) to correlate the response.
>
> **ip** `string`
>
> Optional IP address (IPv4 or IPv6) to localize the query.
>
> **name** `string` *required*
>
> First name to query gender for.
>
> **locale** `string`
>
> Optional locale to guide gender inference.
>
> **askToAI** `boolean`
>
> Ask AI model when the name isn’t present in the database.
>
> **country** `string`
>
> Optional ISO 3166 alpha-2 country code to localize the query.
>
> **forceToGenderize** `boolean`
>
> Attempt to genderize even for non-typical names (e.g., nicknames).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Gender from Username
>
> **Slug:** `GENDERAPI_IO_GET_GENDER_FROM_USERNAME`
>
> Tool to determine gender from a username or nickname. Use when you have an alias or handle and want to infer gender from that identifier.
>
> #### Input Parameters
>
> **askToAI** `boolean`
>
> If true, asks the AI model when the name is not found in the database.
>
> **country** `string`
>
> Optional ISO 3166-1 alpha-2 country code to improve prediction accuracy.
>
> **username** `string` *required*
>
> Username or nickname to analyze for gender inference.
>
> **forceToGenderize** `boolean`
>
> If true, attempts prediction even for usernames that don't resemble real names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Gender API Error Codes
>
> **Slug:** `GENDERAPI_IO_LIST_ERROR_CODES`
>
> Return a static list of six error codes with HTTP statuses and descriptions for debugging or validating API responses. The list is based on Gender-API.com documentation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query gender by email address
>
> **Slug:** `GENDERAPI_IO_QUERY_BY_EMAIL_ADDRESS`
>
> Tool to determine gender from an email address. Use when you need to infer gender for personalization after obtaining proper consent.
>
> #### Input Parameters
>
> **id** `string`
>
> Optional client-provided ID (max 50 characters) for tracing.
>
> **ip** `string`
>
> Valid IPv4 or IPv6 address for geo-hinting.
>
> **email** `string` *required*
>
> Email address to query; must be a valid email format.
>
> **locale** `string`
>
> Browser locale to improve name parsing (e.g., 'en', 'fr').
>
> **country** `string`
>
> ISO 3166-1 alpha-2 country code to hint the endpoint (uppercase).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
