---
title: "Extract a name and infer gender from one email address"
method: POST
path: "/api/email"
tags: ["Gender inference"]
---

# Extract a name and infer gender from one email address

`POST /api/email`

## Request

- Base URL: `https://api.genderapi.io`
- URL: `https://api.genderapi.io/api/email`
- Auth: HTTP bearer

Canonical documentation: https://www.genderapi.io/docs-gender-from-email-single

## Request body

- object
  - `email` string, required
  - `country` string: ISO 3166-1 alpha-2 country code used as regional context.
  - `askToAI` boolean

## Response `200`

Application response. Inspect status before reading result fields; live verification observed validation and authentication errors inside HTTP 200 responses.

- union
  - SingleLookupResponse
    - `status` true, required
    - `used_credits` integer: Credits consumed for processed records.
    - `remaining_credits` integer
    - `expires` integer: Package expiration as a UNIX timestamp.
    - `duration` string
    - `name` string
    - `q` string: Original submitted value.
    - `gender` 'male' | 'female' | 'null': Probabilistic result. An unresolved input is returned as the literal string "null", not JSON null.
    - `country` string: ISO 3166-1 alpha-2 country code used as regional context.
    - `total_names` integer
    - `probability` integer
    - `id` union: Caller record identifier.
      - string
      - integer
  - Error
    - `status` false, required
    - `errno` 50 | 90 | 91 | 92 | 93 | 94 | 99, required
    - `errmsg` string, required

## Other responses

- `400`: Request rejected. Branch on errno rather than errmsg text.
- `401`: Request rejected. Branch on errno rather than errmsg text.
- `403`: Request rejected. Branch on errno rather than errmsg text.
- `404`: Authentication rejected by a gender-inference handler. Current backend compatibility behavior uses HTTP 404 with an Error body for this branch.
- `429`: Request rejected. Branch on errno rather than errmsg text.

---

[API](https://skmtc.dev/genderapi/apis/genderapi-public-api.md) · [All operations](https://skmtc.dev/genderapi/apis/genderapi-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genderapi/apis/genderapi-public-api/revisions/800e7a9d2a0e?raw)