Usage & Quota
The GenderAPI platform allows you to check your current account credit balance at any time via a dedicated endpoint. This can help you monitor your usage and avoid unexpected interruptions when running high-volume operations.
✅ Check Your Remaining Credits
You can retrieve your current quota information using the following endpoint:
GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEYExample request with curl:
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"✅ Example Response
The API returns a JSON object:
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}Response Fields
| Field | Type | Description |
|---|---|---|
| status | Boolean | Indicates if the request was successful. Returns true if your API key is valid. |
| remaining | Integer | Number of API credits left in your account. |
| expiresAt | Integer (timestamp) | Unix timestamp indicating when your current credit package expires. |
Use Cases
- Display current quota information in your dashboard UI.
- Trigger alerts when your credits drop below a threshold.
- Integrate with billing or monitoring tools to avoid service interruptions.
Important:
Always keep track of your remaining credits to avoid unexpected errors due to exhausted limits. High-volume or automated scripts should check your quota periodically.