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

# Gender API

> Gender API determines the gender of a first name, email address, or username.

![Gender API logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/gender_api.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=f2e452b5b578eea4f6b535ffdb6258a4)

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

## Tools

> [accordion] Get Country of Origin
>
> **Slug:** `GENDER_API_GET_COUNTRY_OF_ORIGIN`
>
> Tool to retrieve a name's likely countries of origin. Use after confirming the name identifier.
>
> #### Input Parameters
>
> **id** `string`
>
> Client-defined request ID for correlation (max 50 chars).
>
> **email** `string`
>
> Email address to query; can be provided instead of first\_name.
>
> **full\_name** `string`
>
> Full name to query; can be provided instead of first\_name.
>
> **first\_name** `string`
>
> First name to query. Required if full\_name and email are not provided.
>
> #### 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 Country of Origin (v1)
>
> **Slug:** `GENDER_API_GET_COUNTRY_OF_ORIGIN_V1`
>
> Tool to get the country of origin for a given first name using v1 API. Returns the most likely country where the name is most common.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> First name to query country of origin for. Must contain at least one non-space character.
>
> #### 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 API Statistics
>
> **Slug:** `GENDER_API_GET_STATISTIC`
>
> Tool to retrieve account statistics from Gender-API, including remaining credits and usage details. Use when you need to check your credit balance before performing further gender lookups.
>
> #### 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:** `GENDER_API_QUERY_BY_EMAIL_ADDRESS`
>
> Determine likely gender from an email address by extracting and analyzing the name portion. Returns male/female/unknown with a confidence score. Optionally filter by country for improved accuracy. Check result\_found to know if a determination was made; probability indicates confidence level.
>
> #### Input Parameters
>
> **id** `string`
>
> Client-provided correlation ID
>
> **ip** `string`
>
> Valid IPv4 or IPv6 address
>
> **email** `string` *required*
>
> Email address to query for gender determination
>
> **locale** `string`
>
> Browser locale code (e.g., 'en\_US')
>
> **country** `string`
>
> ISO 3166 ALPHA-2 country code
>
> #### 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 Multiple Email Addresses
>
> **Slug:** `GENDER_API_QUERY_BY_EMAIL_ADDRESS_MULTIPLE`
>
> Query likely gender for multiple email addresses in a single batch request. Results can include gender, probability and a result-found flag, or per-item error details.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> List of email queries to process in a single batch request
>
> #### 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] Gender From First Name
>
> **Slug:** `GENDER_API_QUERY_BY_FIRST_NAME`
>
> Tool to determine the gender of a first name. Use when you need to identify gender based on a given name.
>
> #### Input Parameters
>
> **id** `string`
>
> Client-defined correlation ID, max 50 characters.
>
> **ip** `string`
>
> Valid IPv4 or IPv6 address.
>
> **locale** `string`
>
> Browser locale, e.g., 'en-US'.
>
> **country** `string`
>
> ISO 3166 ALPHA-2 country code.
>
> **first\_name** `string` *required*
>
> Name to query.
>
> #### 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 Full Name
>
> **Slug:** `GENDER_API_QUERY_BY_FULL_NAME`
>
> Tool to determine gender by splitting a full name. Use when you have an exact full name string and want to infer gender. Slightly less reliable for rare or ambiguous names.
>
> #### Input Parameters
>
> **id** `string`
>
> Arbitrary ID (max 50 chars) for correlating batch responses.
>
> **ip** `string`
>
> Valid IPv4 or IPv6 address for geo-based gender inference.
>
> **locale** `string`
>
> Browser locale string (e.g., en\_US) for more accurate inference.
>
> **country** `string`
>
> ISO 3166 alpha-2 country code to hint regional gender conventions.
>
> **full\_name** `string` *required*
>
> Full name to query; must contain at least one non-space character.
>
> #### 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 Multiple First Names
>
> **Slug:** `GENDER_API_QUERY_GENDER_BY_FIRST_NAME_MULTIPLE`
>
> Query gender for multiple first names in a single batch request.
>
> #### Input Parameters
>
> **names** `array` *required*
>
> List of name queries to process in a single batch request.
>
> #### 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 Full Name (Multiple)
>
> **Slug:** `GENDER_API_QUERY_GENDER_BY_FULL_NAME_MULTIPLE`
>
> Submit a batch of name strings for gender queries, with optional country, locale or IP context. Each name is sent as a first-name field.
>
> #### Input Parameters
>
> **names** `array` *required*
>
> List of name query items to process in a single batch request.
>
> #### 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
