API Dokumentation Unified API v2.0

API v1.0

Wir bieten auch eine weitere API-Version mit Schnittstellen an, die einfacher zu integrieren sind. Wenn du Anfänger in der Implementierung von APIs bist, kannst du auch zu der Dokumentation des 1.0er Endpunkts wechseln.
API v1.0 anzeigen

OpenAPI

Schau dir unsere Dokumentation mit Swagger an

Postman

Importiere unsere API-Definitionen in Postman
Abfrage anhand eines Vornamens
Abfrage anhand eines vollständigen Namens
Abfrage anhand einer E-Mail Adresse
Abfrage des Herkunftslandes
Statistiken abfragen
Fehler Codes

Abfrage nur mit einem Vornamen

Das ist der einfachste Weg, das Geschlecht zu bestimmen. Alle Antworten unseres Servers sind im JSON Format:

Post
Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
link
JSON Payload
Feld Typ Benötigt Beschreibung
first_name string Ja Name der abgefragt werden soll
country string Nein ISO 3166 ALPHA-2 Länderkürzel
link
locale string Nein Browser Locale
ip string Nein Gültige IPv4 oder IPv6 Adresse
id string Nein Max. 50 Zeichen. Du kannst diesem Feld einen beliebigen Alphanumerischen Wert mitgeben. Beispielsweise kann als ID die interne ID des Datensatzes aus deiner Datenbank gesetzt werden. In einer asynchronen Umgebung kann dadurch z.B. unsere Serverantwort besser der vorhergehenden Anfrage zugeordnet werden

Beispiele

Abfrage nur mit einem Vornamen
play_arrow Live auf copepen.io testen 
{"first_name":"Sandra"}
Abfrage nach Vornamen und Ländercode
play_arrow Live auf copepen.io testen 
{"first_name":"Sandra","country":"US"}
Abfrage nach Vorname und Browser Locale
play_arrow Live auf copepen.io testen 
{"first_name":"Sandra","locale":"en_US"}
Abfrage anhand des Vornamens und benutze eine IP Adresse zur Lokalisierung
play_arrow Live auf copepen.io testen 
{"first_name":"Sandra","ip":"54.201.16.177"}
Abfrage mehrere Namen in einem einzigen Query
play_arrow Live auf copepen.io testen 
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
Antwort
{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}
Feld Typ Beschreibung
input object Der übergebene Input
details.credits_used int Die Anzahl an Anfragen, die für diesen Query nötig waren
details.samples int Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden
details.country string Das gefundene Land
details.first_name_sanitized string Der Name, nachdem wir ihn normalisiert haben
details.duration string Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln
result_found bool True, wenn wir ein Geschlecht zum angegebenen Namen bestimmen konnten
first_name string Der gefundene Vorname, den wir zur Bestimmung des Geschlechts genutzt haben
probability float Dieser Wert (zwischen 0 und 1) bestimmt, wie sicher wir uns sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 1 sagt aus, dass wir uns zu 100% sicher sind.
gender string Mögliche Antworten: male, female, uknown

Abfrage eines vollständigen Namens - VOR- UND NACHNAME SPLITTEN

Wenn du ein kombiniertes Feld für Vor- und Nachname auf deiner Webseite hast, benutze diesen API Endpunkt um die entsprechenden Teile zu extrahieren:

Post
Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
link
JSON Payload
Feld Typ Benötigt Beschreibung
full_name string Ja Name der abgefragt werden soll
country string Nein ISO 3166 ALPHA-2 Länderkürzel
link
locale string Nein Browser Locale
ip string Nein Gültige IPv4 oder IPv6 Adresse
id string Nein Max. 50 Zeichen. Du kannst diesem Feld einen beliebigen Alphanumerischen Wert mitgeben. Beispielsweise kann als ID die interne ID des Datensatzes aus deiner Datenbank gesetzt werden. In einer asynchronen Umgebung kann dadurch z.B. unsere Serverantwort besser der vorhergehenden Anfrage zugeordnet werden

Beispiele

Abfrage eines vollständigen Namens
play_arrow Live auf copepen.io testen 
{"full_name":"Theresa Miller"}
Abfrage eines vollständigen Namens mit Ländercode
play_arrow Live auf copepen.io testen 
{"full_name":"Theresa Miller","country":"US"}
Abfrage anhand des vollständigen Namens und benutze die Browser Locale zur Lokalisierung
play_arrow Live auf copepen.io testen 
{"full_name":"Thomas Johnson","locale":"en_US"}
Abfrage anhand des vollständigen Namens und benutze eine IP Adresse zur Lokalisierung
play_arrow Live auf copepen.io testen 
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
Abfrage mehrere Namen in einem einzigen Query
play_arrow Live auf copepen.io testen 
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
Antwort
{
    "input": {
        "full_name": "Theresa Miller"
    },
    "details": {
    "credits_used": 1,
        "duration": "33ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}
Feld Typ Beschreibung
input object Der übergebene Input
details.credits_used int Die Anzahl an Anfragen, die für diesen Query nötig waren
details.samples int Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden
details.country string Das gefundene Land
details.full_name_sanitized int Der Name, nachdem wir ihn normalisiert haben
details.duration string Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln
result_found bool True, wenn wir ein Geschlecht zum angegebenen Namen bestimmen konnten
full_name string Der vollständige Name, den wir für die Bestimmung des Geschlechts verwendet haben
probability float Dieser Wert (zwischen 0 und 1) bestimmt, wie sicher wir uns sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 1 sagt aus, dass wir uns zu 100% sicher sind.
gender string Mögliche Antworten: male, female, uknown

Abfrage anhand einer E-Mail Adresse

Du kannst unsere Datenbank auch nach E-Mail Adressen abfragen, die einen Vornamen enthalten:

Post
Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
link
JSON Payload
Feld Typ Benötigt Beschreibung
email string Ja Zu abfragende E-Mail-Adresse
country string Nein ISO 3166 ALPHA-2 Länderkürzel
link
locale string Nein Browser Locale
ip string Nein Gültige IPv4 oder IPv6 Adresse
id string Nein Max. 50 Zeichen. Du kannst diesem Feld einen beliebigen Alphanumerischen Wert mitgeben. Beispielsweise kann als ID die interne ID des Datensatzes aus deiner Datenbank gesetzt werden. In einer asynchronen Umgebung kann dadurch z.B. unsere Serverantwort besser der vorhergehenden Anfrage zugeordnet werden

Beispiele

Abfrage anhand einer E-Mail Adresse
play_arrow Live auf copepen.io testen 
{"email":"theresa.miller14@gmail.com"}
Abfrage anhand einer E-Mail Adresse und eines Ländercodes
play_arrow Live auf copepen.io testen 
{"email":"thomas.clarks@hotmail.com","country":"US"}
Abfrage anhand einer E-Mail Adresse und benutze die Browser Locale zur Lokalisierung
play_arrow Live auf copepen.io testen 
{"email":"Thomas.j32@live.com","locale":"en_US"}
Abfrage anhand einer E-Mail Adresse und benutze eine IP Adresse zur Lokalisierung
play_arrow Live auf copepen.io testen 
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Abfrage mehrere Namen in einem einzigen Query
play_arrow Live auf copepen.io testen 
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Antwort
{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}
Feld Typ Beschreibung
input object Der übergebene Input
details.credits_used int Die Anzahl an Anfragen, die für diesen Query nötig waren
details.samples int Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden
details.country string Das gefundene Land
details.email_sanitized int Der Name, nachdem wir ihn normalisiert haben
details.duration string Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln
result_found bool True, wenn wir ein Geschlecht zum angegebenen Namen bestimmen konnten
email string Die e-Mail-Adresse, die wir für die Bestimmung des Geschlechts verwendet haben
probability float Dieser Wert (zwischen 0 und 1) bestimmt, wie sicher wir uns sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 1 sagt aus, dass wir uns zu 100% sicher sind.
gender string Mögliche Antworten: male, female, uknown

Abfrage des Herkunftslandes

Abfrage des Herkunftslandes eines Namens:

Post
Benötigtes Guthaben: 2
URL
https://gender-api.com/v2/country-of-origin
Headers
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
link
JSON Payload
Feld Typ Benötigt Beschreibung
first_name string Ja Vorname der abgefragt werden soll
full_name string Nein Abzufragender vollständiger Name. Kann alternativ zum first_name Feld gesendet werden
email string Nein Abzufragende E-Mail Adresse. Kann alternativ zum first_name Feld gesendet werden
id string Nein Max. 50 Zeichen. Du kannst diesem Feld einen beliebigen Alphanumerischen Wert mitgeben. Beispielsweise kann als ID die interne ID des Datensatzes aus deiner Datenbank gesetzt werden. In einer asynchronen Umgebung kann dadurch z.B. unsere Serverantwort besser der vorhergehenden Anfrage zugeordnet werden

Beispiele

Abfrage nur mit einem Vornamen
play_arrow Live auf copepen.io testen 
{"first_name":"Johann"}
Abfrage eines vollständigen Namens
play_arrow Live auf copepen.io testen 
{"full_name":"Theresa Miller"}
Abfrage anhand einer E-Mail Adresse
play_arrow Live auf copepen.io testen 
{"full_name":"sophia5342@gmail.com"}
Antwort
{
    "input": {
        "first_name": "Johann",
        "id": 12
    },
    "details": {
        "credits_used": 2,
        "duration": "414ms",
        "samples": 890,
        "country": null,
        "first_name_sanitized": "johann"
    },
    "result_found": true,
    "country_of_origin": [
        {
            "country_name": "Germany",
            "country": "DE",
            "probability": 0.52,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        },
        {
            "country_name": "Austria",
            "country": "AT",
            "probability": 0.48,
            "continental_region": "Europe",
            "statistical_region": "Western Europe"
        }
    ],
    "first_name": "Johann",
    "probability": 0.9,
    "gender": "male"
 }
Feld Typ Beschreibung
input object Der übergebene Input
details.credits_used int Die Anzahl an Anfragen, die für diesen Query nötig waren
details.samples int Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden
details.country string Das gefundene Land
details.first_name_sanitized string Der Name, nachdem wir ihn normalisiert haben
details.duration string Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln
result_found bool True, wenn wir ein Geschlecht zum angegebenen Namen bestimmen konnten
country_of_origin_map_url string URL zu einer interaktiven Karte zu diesem Namen
first_name string Der gefundene Vorname, den wir zur Bestimmung des Geschlechts genutzt haben
probability float Dieser Wert (zwischen 0 und 1) bestimmt, wie sicher wir uns sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 1 sagt aus, dass wir uns zu 100% sicher sind
gender string Mögliche Antworten: male, female, uknown
country_of_origin object Top 25 Herkunftsländer. Eine Liste der unterstützten Länder finden Sie unter "Komplette Liste der möglichen Länder“. Jeder Datensatz enthält die Felder country_name, country, probability, continental_region und statistical_region
Screenshot der interaktiven Karte
Vollständige Liste der möglichen Länder
Ländercode Name des Landes Statistische Region Kontinentale Region
CN China Eastern Asia Asia
IN India Southern Asia Asia
US United States Northern America Americas
ID Indonesia South-eastern Asia Asia
BR Brazil South America Americas
PK Pakistan Southern Asia Asia
NG Nigeria Western Africa Africa
BD Bangladesh Southern Asia Asia
RU Russia Eastern Europe Europe
MX Mexico Central America Americas
JP Japan Eastern Asia Asia
ET Ethiopia Eastern Africa Africa
PH Philippines South-eastern Asia Asia
EG Egypt Northern Africa Africa
VN Vietnam South-eastern Asia Asia
DE Germany Western Europe Europe
CD Democratic Republic of the Congo Middle Africa Africa
IR Iran Southern Asia Asia
TR Turkey Western Asia Asia
TH Thailand South-eastern Asia Asia
GB United Kingdom Northern Europe Europe
FR France Western Europe Europe
IT Italy Southern Europe Europe
TZ Tanzania Eastern Africa Africa
ZA South Africa Southern Africa Africa
MM Myanmar South-eastern Asia Asia
KR South Korea Eastern Asia Asia
CO Colombia South America Americas
KE Kenya Eastern Africa Africa
ES Spain Southern Europe Europe
AR Argentina South America Americas
UA Ukraine Eastern Europe Europe
UG Uganda Eastern Africa Africa
DZ Algeria Northern Africa Africa
SD Sudan Northern Africa Africa
IQ Iraq Western Asia Asia
PL Poland Eastern Europe Europe
CA Canada Northern America Americas
MA Morocco Northern Africa Africa
AF Afghanistan Southern Asia Asia
SA Saudi Arabia Western Asia Asia
PE Peru South America Americas
VE Venezuela South America Americas
UZ Uzbekistan Central Asia Asia
MY Malaysia South-eastern Asia Asia
AO Angola Middle Africa Africa
MZ Mozambique Eastern Africa Africa
NP Nepal Southern Asia Asia
GH Ghana Western Africa Africa
YE Yemen Western Asia Asia
MG Madagascar Eastern Africa Africa
KP North Korea Eastern Asia Asia
AU Australia AustraliaandNew Zealand Oceania
CI Ivory Coast Western Africa Africa
CM Cameroon Middle Africa Africa
TW Taiwan Eastern Asia Asia
NE Niger Western Africa Africa
LK Sri Lanka Southern Asia Asia
RO Romania Eastern Europe Europe
BF Burkina Faso Western Africa Africa
MW Malawi Eastern Africa Africa
ML Mali Western Africa Africa
SY Syria Western Asia Asia
KZ Kazakhstan Central Asia Asia
CL Chile South America Americas
ZM Zambia Eastern Africa Africa
NL Netherlands Western Europe Europe
GT Guatemala Central America Americas
EC Ecuador South America Americas
ZW Zimbabwe Eastern Africa Africa
KH Cambodia South-eastern Asia Asia
SN Senegal Western Africa Africa
TD Chad Middle Africa Africa
SO Somalia Eastern Africa Africa
GN Guinea Western Africa Africa
SD Sudan Northern Africa Africa
RW Rwanda Eastern Africa Africa
TN Tunisia Northern Africa Africa
CU Cuba Caribbean Americas
BE Belgium Western Europe Europe
BJ Benin Western Africa Africa
GR Greece Southern Europe Europe
BO Bolivia South America Americas
HT Haiti Caribbean Americas
BI Burundi Eastern Africa Africa
DO Dominican Republic Caribbean Americas
CZ Czech Republic Eastern Europe Europe
PT Portugal Southern Europe Europe
SE Sweden Northern Europe Europe
AZ Azerbaijan Western Asia Asia
HU Hungary Eastern Europe Europe
JO Jordan Western Asia Asia
BY Belarus Eastern Europe Europe
AE United Arab Emirates Western Asia Asia
HN Honduras Central America Americas
TJ Tajikistan Central Asia Asia
RS Serbia Southern Europe Europe
AT Austria Western Europe Europe
CH Switzerland Western Europe Europe
IL Israel Western Asia Asia
PG Papua New Guinea Melanesia Oceania
TG Togo Western Africa Africa
SL Sierra Leone Western Africa Africa
HK Hong Kong Eastern Asia Asia
BG Bulgaria Eastern Europe Europe
LA Laos South-eastern Asia Asia
PY Paraguay South America Americas
SV El Salvador Central America Americas
LY Libya Northern Africa Africa
NI Nicaragua Central America Americas
LB Lebanon Western Asia Asia
KG Kyrgyzstan Central Asia Asia
TM Turkmenistan Central Asia Asia
DK Denmark Northern Europe Europe
SG Singapore South-eastern Asia Asia
FI Finland Northern Europe Europe
SK Slovakia Eastern Europe Europe
NO Norway Northern Europe Europe
CG Congo Middle Africa Africa
ER Eritrea Eastern Africa Africa
PS Palestine Western Asia Asia
CR Costa Rica Central America Americas
IE Ireland Northern Europe Europe
LR Liberia Western Africa Africa
NZ New Zealand AustraliaandNew Zealand Oceania
CF Central African Republic Middle Africa Africa
OM Oman Western Asia Asia
MR Mauritania Western Africa Africa
HR Croatia Southern Europe Europe
KW Kuwait Western Asia Asia
PA Panama Central America Americas
MD Moldova Eastern Europe Europe
GE Georgia Western Asia Asia
PR Puerto Rico Caribbean Americas
BA Bosnia and Herzegovina Southern Europe Europe
UY Uruguay South America Americas
MN Mongolia Eastern Asia Asia
AM Armenia Western Asia Asia
AL Albania Southern Europe Europe
JM Jamaica Caribbean Americas
LT Lithuania Northern Europe Europe
QA Qatar Western Asia Asia
NA Namibia Southern Africa Africa
BW Botswana Southern Africa Africa
LS Lesotho Southern Africa Africa
GM The Gambia Western Africa Africa
MK Republic of Macedonia Southern Europe Europe
SI Slovenia Southern Europe Europe
GA Gabon Middle Africa Africa
LV Latvia Northern Europe Europe
GW Guinea-Bissau Western Africa Africa
BH Bahrain Western Asia Asia
TT Trinidad and Tobago Caribbean Americas
SZ Swaziland Southern Africa Africa
EE Estonia Northern Europe Europe
TL East Timor South-eastern Asia Asia
GQ Equatorial Guinea Middle Africa Africa
MU Mauritius Eastern Africa Africa
CY Cyprus Western Asia Asia
DJ Djibouti Eastern Africa Africa
FJ Fiji Melanesia Oceania
RE Réunion Eastern Africa Africa
KM Comoros Eastern Africa Africa
BT Bhutan Southern Asia Asia
GY Guyana South America Americas
ME Montenegro Southern Europe Europe
MO Macau Eastern Asia Asia
SB Solomon Islands Melanesia Oceania
LU Luxembourg Western Europe Europe
SR Suriname South America Americas
EH Western Sahara Northern Africa Africa
CV Cape Verde Western Africa Africa
GP Guadeloupe Caribbean Americas
MV Maldives Southern Asia Asia
MT Malta Southern Europe Europe
BN Brunei South-eastern Asia Asia
BS Bahamas Caribbean Americas
MQ Martinique Caribbean Americas
BZ Belize Central America Americas
IS Iceland Northern Europe Europe
BB Barbados Caribbean Americas
PF French Polynesia Polynesia Oceania
GF French Guiana South America Americas
NC New Caledonia Melanesia Oceania
VU Vanuatu Melanesia Oceania
YT Mayotte Eastern Africa Africa
ST Sao Tome and Principe Middle Africa Africa
WS Samoa Polynesia Oceania
LC Saint Lucia Caribbean Americas
JE Guernsey and Jersey Northern Europe Europe
GU Guam Micronesia Oceania
CW Curaçao Caribbean Americas
KI Kiribati Micronesia Oceania
VC Saint Vincent and the Grenadines Caribbean Americas
TO Tonga Polynesia Oceania
GD Grenada Caribbean Americas
FM Federated States of Micronesia Micronesia Oceania
AW Aruba Caribbean Americas
VI United States Virgin Islands Caribbean Americas
AG Antigua and Barbuda Caribbean Americas
SC Seychelles Eastern Africa Africa
IM Isle of Man Northern Europe Europe
AD Andorra Southern Europe Europe
DM Dominica Caribbean Americas
KY Cayman Islands Caribbean Americas
BM Bermuda Northern America Americas
GL Greenland Northern America Americas
AS American Samoa Polynesia Oceania
KN Saint Kitts and Nevis Caribbean Americas
MP Northern Mariana Islands Micronesia Oceania
MH Marshall Islands Micronesia Oceania
FO Faroe Islands Northern Europe Europe
SX Sint Maarten Caribbean Americas
MC Monaco Western Europe Europe
LI Liechtenstein Western Europe Europe
TC Turks and Caicos Islands Caribbean Americas
GI Gibraltar Southern Europe Europe
SM San Marino Southern Europe Europe
VG British Virgin Islands Caribbean Americas
BQ Caribbean Netherlands Caribbean Americas
PW Palau Micronesia Oceania
CK Cook Islands Polynesia Oceania
AI Anguilla Caribbean Americas
WF Wallis and Futuna Polynesia Oceania
NR Nauru Micronesia Oceania
TV Tuvalu Polynesia Oceania
PM Saint Pierre and Miquelon Northern America Americas
MS Montserrat Caribbean Americas
SH Saint Helena Ascension and Tristan da Cunha Western Africa Africa
FK Falkland Islands South America Americas
NU Niue Polynesia Oceania
TK Tokelau Polynesia Oceania
VA Vatican City Southern Europe Europe

Statistiken abfragen

Mit diesem Aufruf kannst du einige Statistiken zu deinem Account abfragen:

Get
URL
https://gender-api.com/v2/statistic
Headers
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
link
Antwort
{
    "is_limit_reached": false,
    "remaining_credits": 24999,
    "details": {
        "credits_used": 0,
        "duration": "83ms"
    },
    "usage_last_month": {
        "date": "2018-03",
        "credits_used": 25
    }
}
Feld Typ Beschreibung
is_limit_reached bool Gibt true zurück, wenn keine Anfragen mehr vorhanden ist
remaining_credits int Noch verfügbares Guthaben
details.credits_used int Die Anzahl an Anfragen, die für diesen Query nötig waren
details.duration string Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln
usage_last_month.date string Datum des letzten Monats
usage_last_month.credits_used int Verfügbare Anfragen, die letzten Monat verbraucht wurden

Fehler 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 3 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.
Dieses Produkt enthält GeoLite2 Daten erstellt von MaxMind, verfügbar von http://www.maxmind.com.
Chat
Wir benötigen deine Zustimmung
Wir verwenden Cookies (auch von Drittanbietern), um Informationen über die Nutzung unserer Website durch Besucher zu sammeln. Diese Cookies helfen uns dabei, dir das bestmögliche Online-Erlebnis zu bieten, unsere Websites ständig zu verbessern. Über Cookies gesammelte Informationen können auch außerhalb der Europäischen Union, etwa in den USA verarbeitet werden. Mit dem Klick auf den Button „Ja, ich stimme zu“ erklärst du dich mit der Verwendung von Cookies einverstanden. Um deine Einwilligung jederzeit zu widerrufen, deine Einstellungen zu ändern und für weitere Informationen über die Nutzung von Cookies klicke hier oder auf “Cookie Einstellungen” am Ende der Seite.
Datenschutz Nutzungsbedingungen
Ja, ich stimme zu Nein, ich lehne ab