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

Get Stats

With this call you can pull some stats on your account:

Get
URL
https://gender-api.com/v2/statistic
Headers
Content-Type: application/json
Authorization: Bearer <your authorization token>
link
Response
{
    "is_limit_reached": false,
    "remaining_credits": 24999,
    "details": {
        "credits_used": 0,
        "duration": "83ms"
    },
    "usage_last_month": {
        "date": "2018-03",
        "credits_used": 25
    }
}
Field Type Description
is_limit_reached bool Returns true if there are no more requests left
remaining_credits int Number of requests left
details.credits_used int The amount of requests used for this query
details.duration string Time the server needed to process the request
usage_last_month.date string Last month's date
usage_last_month.credits_used int Requests that you have used over the last month
This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.
Chat