Usage & Quota

The GenderAPI platform allows you to check your current credit balance at any time using a dedicated endpoint. This helps you monitor your usage and avoid unexpected interruptions during high-volume operations.

✅ Check Your Remaining Credits

You can retrieve your current quota information by using the following endpoint:

GET https://api.genderapi.io/api/remaining?key=YOUR_API_KEY

Example request using 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 whether the request was successful. Returns true if your API key is valid.
remaining Integer The number of API credits remaining in your account.
expiresAt Integer (timestamp) Unix timestamp indicating when your current credit package will expire.

Usage Scenarios

  • Display the current quota in your dashboard interface.
  • Trigger alerts when your credits fall below a certain threshold.
  • Integrate with billing or monitoring tools to avoid service disruptions.
Important: Always keep track of your remaining credits to avoid unexpected errors due to quota exhaustion. High-volume or automated scripts should regularly check your quota status.