# GenderAPI error codes

> Branch on stable errno values and keep errmsg for human-readable diagnostics.

Canonical HTML: https://www.genderapi.io/docs-error-codes

Last reviewed: 2026-09-14

## Error reference

| errno | Meaning | Action |
| --- | --- | --- |
| 50 | access denied | Review API-key IP or referrer restrictions. |
| 90 | invalid country code | Validate an ISO 3166-1 alpha-2 country code. |
| 91 | required input not set | Add the endpoint's required name, email, or username. |
| 92 | batch limit exceeded | Split input according to the documented endpoint limit. |
| 93 | query limit reached | Pause lookups and review the account quota. |
| 94 | invalid or missing key | Check server-side credential injection. |
| 99 | API key has expired | Review or renew the package before retrying. |

## Handling rules

- Validate required inputs, country codes, and batch sizes before calling the API.
- Do not retry authentication, access, quota, expiration, or invalid-input failures unchanged.
- Redact API keys and personal inputs from logs.