---
title: "Retrieve remaining quota and expiration"
method: GET
path: "/api/remaining"
tags: ["Quota"]
---

# Retrieve remaining quota and expiration

`GET /api/remaining`

## Request

- Base URL: `https://api.genderapi.io`
- URL: `https://api.genderapi.io/api/remaining`
- Auth: API key in query parameter `key`

This endpoint requires the key query parameter. Keep the request server-side and redact the full URL and query string from logs; Bearer authentication was rejected with errno 94 during live verification.

## Response `200`

Quota information

- union
  - QuotaResponse
    - `status` true, required
    - `remaining` integer, required
    - `expiresAt` integer, required: Expiration as a UNIX timestamp.
  - Error
    - `status` false, required
    - `errno` 50 | 90 | 91 | 92 | 93 | 94 | 99, required
    - `errmsg` string, required

## Other responses

- `401`: Request rejected. Branch on errno rather than errmsg text.
- `403`: Request rejected. Branch on errno rather than errmsg text.

---

[API](https://skmtc.dev/genderapi/apis/genderapi-public-api.md) · [All operations](https://skmtc.dev/genderapi/apis/genderapi-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genderapi/apis/genderapi-public-api/revisions/800e7a9d2a0e?raw)