# Infer gender from multiple names

> Canonical documentation: https://www.genderapi.io/docs-gender-from-name-multiple

Canonical HTML: https://www.genderapi.io/docs-gender-from-name-multiple

Last reviewed: 2026-09-14

## Request

POST https://api.genderapi.io/api/name/multi/country

Use Bearer authentication from trusted server-side code. Check the canonical OpenAPI document before production use.

| Field | Type | Requirement | Description |
| --- | --- | --- | --- |
| data | object[] | Required | See OpenAPI schema. |
| data[].name | string | Required | See OpenAPI schema. |
| data[].country | string | Optional | ISO 3166-1 alpha-2 country code used as regional context. |
| data[].id | string integer | Optional | Caller record identifier. |

```json
{
  "data": [
    {
      "name": "Andrea",
      "country": "DE",
      "id": "123"
    }
  ]
}
```

## Response

A successful lookup may still return a null gender. Preserve probability and unknown outcomes.

| Field | Type | Description |
| --- | --- | --- |
| status | boolean | Returned response field. |
| used_credits | integer | Credits consumed for processed records. |
| remaining_credits | integer | Returned response field. |
| expires | integer | Package expiration as a UNIX timestamp. |
| duration | string | Returned response field. |
| names | object[] | Contains a result for every processed input, including unresolved results with gender "null". Live verification observed that a malformed entry missing the required name was omitted while valid entries were processed. |

```json
{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "names": [
    {
      "q": "Andrea",
      "name": "andrea",
      "gender": "female",
      "country": "US",
      "total_names": 1234,
      "probability": 92,
      "id": "123"
    }
  ],
  "duration": "5ms"
}
```

## Errors and usage

Credits are consumed per processed record, not per HTTP request.

- [Error codes](https://www.genderapi.io/docs-error-codes)
- [Authentication](https://www.genderapi.io/docs-authentication)
- [OpenAPI JSON](https://www.genderapi.io/openapi/openapi.json)