# Documentatie van GenderAPI.io V2

> Koppel uw applicatie via api.genderapi.io aan GenderAPI.io V2. Ontvang voorspellingen op basis van namen, e-mailadressen of gebruikersnamen, verwerk gemengde batches en lees de resultaten samen met de metadata over toegang en afschrijving.

Canonical HTML: https://www.genderapi.io/nl/api-documentation

Last reviewed: 2026-09-28

## Verstuur uw eerste verzoek

Gebruik GenderAPI.io V2 om het geslacht te schatten op basis van een voornaam of volledige naam, een e-mailadres of een gebruikersnaam. De API-origin is https://api.genderapi.io en het basispad van V2 is /api/v2. Probeer het GET-voorbeeld hieronder in uw browser en kies daarna een handleiding om uw applicatie te koppelen.

De gratis IP-proefperiode biedt 10 credits per IP-adres per 24 uur, gedeeld met V1. Dit voorbeeld gebruikt alleen de dataset en kost 1 credit per verzoek, ook bij elke keer dat u de pagina opnieuw laadt. Gebruikt u uw bestaande API-sleutel, dan delen V1 en V2 hetzelfde accountsaldo.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Lotte&country=NL&ai_mode=off
```

- [Open het GET-voorbeeld (kost 1 credit van de IP-proefperiode)](https://api.genderapi.io/api/v2/gender?type=name&value=Lotte&country=NL&ai_mode=off)
- [Stel uw API-sleutel in](https://www.genderapi.io/nl/docs/v2/authentication#environment-setup)
- [Het JSON-antwoord begrijpen](https://www.genderapi.io/nl/docs/v2/responses)

## Wat wilt u doen?

Kies uw invoertype voor uitvoerbare voorbeelden in cURL, JavaScript, Python, PHP, Java, C# en Go. Raadpleeg de handleidingen over resultaten en afschrijvingen wanneer u klaar bent om echte antwoorden te verwerken.

- [API-sleutel en IP-proefperiode](https://www.genderapi.io/nl/docs/v2/authentication): Koppel uw API-sleutel of probeer de API gratis.
- [Verzoekparameters](https://www.genderapi.io/nl/docs/v2/request-parameters): Kies invoervelden, landcontext en verzoekopties.
- [Officiële SDK's](https://www.genderapi.io/nl/docs/v2/sdks): Installeer een officiële client voor uw programmeertaal.
- [Geslacht op basis van een naam](https://www.genderapi.io/nl/docs/v2/gender-from-name): Zoek een voornaam of volledige naam op.
- [Geslacht op basis van een e-mailadres](https://www.genderapi.io/nl/docs/v2/gender-from-email): Vind een naamsignaal in een e-mailadres.
- [Geslacht op basis van een gebruikersnaam](https://www.genderapi.io/nl/docs/v2/gender-from-username): Gebruik een gebruikersnaam of bijnaam als invoer.
- [Batchverzoeken](https://www.genderapi.io/nl/docs/v2/batch): Verwerk tot 50 namen, e-mailadressen of gebruikersnamen in één keer.
- [Validatie van telefoonnummers](https://www.genderapi.io/nl/docs/v2/phone-validation): Controleer en formatteer een telefoonnummer.
- [Een antwoord lezen](https://www.genderapi.io/nl/docs/v2/responses): Lees voorspellingen, betrouwbaarheidsscores en onbekende resultaten.
- [AI en bijnamen](https://www.genderapi.io/nl/docs/v2/ai-options): Kies wanneer AI wordt gebruikt en hoe bijnamen worden geïnterpreteerd.
- [Credits en saldo](https://www.genderapi.io/nl/docs/v2/credits-and-usage): Controleer uw saldo en wat elk verzoek kost.
- [Fouten en nieuwe pogingen](https://www.genderapi.io/nl/docs/v2/errors-and-retries): Los fouten op en bepaal wanneer een nieuwe poging zinvol is.
- [Overstappen van V1 naar V2](https://www.genderapi.io/nl/docs/v2/migration): Werk een bestaande integratie bij met dezelfde API-sleutel.

## Overzicht van de endpoints

Combineer https://api.genderapi.io met de absolute paden in deze tabel, bijvoorbeeld https://api.genderapi.io/api/v2/gender. Queryparameters worden alleen ondersteund bij GET /gender. Gebruik voor POST-routes een JSON-body en stuur geen V1-velden zoals name, email, username of askToAI in een V2-verzoek.

| Methode | Pad | Doel |
| --- | --- | --- |
| GET | /api/v2 | Openbare mogelijkheden en huidige limieten; gratis. |
| GET | /api/v2/openapi.json | Het canonieke OpenAPI-contract; gratis. |
| GET | /api/v2/errors | Machineleesbare foutencatalogus; gratis. |
| GET | /api/v2/usage | Huidig saldo van het account of de IP-proefperiode; gratis. |
| GET / POST | /api/v2/gender | Eén naam, e-mailadres of gebruikersnaam. |
| POST | /api/v2/gender/batch | Een geordende batch met namen, e-mailadressen en/of gebruikersnamen. |
| POST | /api/v2/phone/validate | Valideer en formatteer een telefoonnummer. |