menu
Home
About Us
API Docs
API Docs v1.0
API Docs v2.0
API Clients
CSV / Excel
App Integrations
App Integrations
Google Sheets
Microsoft Excel
Apple Numbers
LibreOffice
OpenOffice
Shopify
Mailchimp
Gmail
Cleverreach
OnOffice
Postman
HubSpot
Optimizely
InvoiceBerry
Browse More Apps
Automation / Workflow
Zapier
SureTriggers
API Marketplaces
APILayer
RapidAPI
FAQ
Blog
Contact
Pricing
account_circle
My Account
arrow_drop_down
English
Deutsch
Français
Español
Italiano
Português
Polski
Türkçe
Nederlandse
Sverige
Danmark
Ελλάδα
Home
About Us
API Docs
API Clients
CSV / Excel
App Integrations
FAQ
Blog
Contact
Pricing
account_circle
My Account
API Docs Unified API v2.0
API v1.0
We also offer another API version with endpoints that are easier to integrate. If you're a beginner in implementing API's you can switch to our v1.0 endpoint.
View API v1.0
OpenAPI
View our API documentation in Swagger
Postman
Import our API definition into Postman
Query By First Name
Query By Full Name
Query By Email Address
Get Country Of Origin
Get Stats
Error Codes
Error Codes
endpoint-not-found
Status
endpoint-not-found
HTTP Status Code
404
Description
API endpoint not found
limit-exceeded
Status
limit-exceeded
HTTP Status Code
401
Description
Limit exceeded. Thank you for using our service. Please consider to buy more requests.
parameter-first-name-invalid
Status
parameter-first-name-invalid
HTTP Status Code
400
Description
The "first_name" parameter is invalid. The parameter can only be a string with a length from 1 to 50 chars.
parameter-full-name-invalid
Status
parameter-full-name-invalid
HTTP Status Code
400
Description
The "full_name" parameter is invalid. The parameter can only be a string with a length from 1 to 100 chars.
parameter-email-invalid
Status
parameter-email-invalid
HTTP Status Code
400
Description
The "email" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars and must be a valid email address.
key-parameter-missing
Status
key-parameter-missing
HTTP Status Code
400
Description
The "key" parameter is not set. Please create an account to fetch an API key.
invalid-key
Status
invalid-key
HTTP Status Code
400
Description
Invalid API key. You can find your personal API key in your account.
invalid-country-code
Status
invalid-country-code
HTTP Status Code
400
Description
The given country code is not valid. You can find a list of valid country codes in our API docs.
invalid-ip-address
Status
invalid-ip-address
HTTP Status Code
400
Description
The given ip address is not valid. Please provide either a valid IPv4 or an IPv6 address.
generic-error
Status
generic-error
HTTP Status Code
400
Description
invalid-json
Status
invalid-json
HTTP Status Code
400
Description
invalid-locale
Status
invalid-locale
HTTP Status Code
400
Description
The given locale is not valid. You can find a list of valid country codes in our API docs.
invalid-id
Status
invalid-id
HTTP Status Code
400
Description
The given id is not valid. An id can be either an integer or a string with 50 chars at max.
mandatory-parameter-missing
Status
mandatory-parameter-missing
HTTP Status Code
400
Description
Mandatory parameter missing. Either first_name, full_name or email must be set.
content-type-missing
Status
content-type-missing
HTTP Status Code
400
Description
Content-Type missing. Please add a "Content-Type: application/json" to your API call.
missing-json
Status
missing-json
HTTP Status Code
400
Description
We weren't able to find a json body in your API call. Please make sure the body is sent with a POST request to our API endpoint.
too-many-queries
Status
too-many-queries
HTTP Status Code
400
Description
Too many queries in a single API call.
too-many-queries-api-key
Status
too-many-queries-api-key
HTTP Status Code
400
Description
Too many queries in a single API call. Your API key is limited to 3 lookups per request.
authorization-header-missing
Status
authorization-header-missing
HTTP Status Code
400
Description
Your query misses the "Authorization" header with the bearer token.
invalid-auth-token
Status
invalid-auth-token
HTTP Status Code
400
Description
Invalid authentication token provided. Please log in to your account to find a list of valid tokens or to create a new one.
email-invalid
Status
email-invalid
HTTP Status Code
400
Description
Invalid or empty email address given.
password-invalid
Status
password-invalid
HTTP Status Code
400
Description
Invalid credentials. Login failed. Please also check your account that third-party app access is not restricted.: https://gender-api.com/de/account/password
label-invalid
Status
label-invalid
HTTP Status Code
400
Description
Invalid label given. A label must be a string between 2 and 30 chars.
email-account-not-found
Status
email-account-not-found
HTTP Status Code
400
Description
No Gender-API.com account found. Please create a free account first, to sign-in with Google or try to login with an existing username or password.
invalid-list-of-names
Status
invalid-list-of-names
HTTP Status Code
400
Description
Invalid list of names. Expected array of strings.
This product includes GeoLite2 data created by MaxMind, available from
http://www.maxmind.com
.