curl "https://fapihub.com/v2/account/usage/" \
-H "ApiKey: your_api_key"
import requests
response = requests.get(
"https://fapihub.com/v2/account/usage/",
headers={"ApiKey": "your_api_key"},
)
data = response.json()["data"]
print(f"{data['usage']['remaining']} of {data['limits']['requests']} requests left")
const response = await fetch("https://fapihub.com/v2/account/usage/", {
headers: { "ApiKey": "your_api_key" },
});
const { data } = await response.json();
console.log(`${data.usage.remaining} of ${data.limits.requests} requests left`);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://fapihub.com/v2/account/usage/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["ApiKey: your_api_key"]
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
$data = $response["data"];
echo $data["usage"]["remaining"] . " of " . $data["limits"]["requests"] . " requests left";
?>
{
"success": true,
"data": {
"plan": { "id": "pro", "name": "Pro", "billing": "monthly", "price": 15.0 },
"status": "active",
"can_make_requests": true,
"limits": { "requests": 7500, "requests_per_minute": 150 },
"usage": { "used": 1240, "remaining": 6260, "percent_used": 16.5, "successful": 1225, "failed": 15 },
"billing_period": { "start": "2026-10-01", "end": "2026-11-01" },
"cancel_at_period_end": false,
"end_date": null
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or inactive"
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
Endpoints
Usage & Limits
Returns your plan, limits and quota usage for the current billing period. This call is free: it doesn’t count against your quota, isn’t logged, and keeps working when your quota is used up or your subscription has expired. It has its own limit of 60 calls per minute per key.
GET
/
account
/
usage
/
curl "https://fapihub.com/v2/account/usage/" \
-H "ApiKey: your_api_key"
import requests
response = requests.get(
"https://fapihub.com/v2/account/usage/",
headers={"ApiKey": "your_api_key"},
)
data = response.json()["data"]
print(f"{data['usage']['remaining']} of {data['limits']['requests']} requests left")
const response = await fetch("https://fapihub.com/v2/account/usage/", {
headers: { "ApiKey": "your_api_key" },
});
const { data } = await response.json();
console.log(`${data.usage.remaining} of ${data.limits.requests} requests left`);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://fapihub.com/v2/account/usage/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["ApiKey: your_api_key"]
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
$data = $response["data"];
echo $data["usage"]["remaining"] . " of " . $data["limits"]["requests"] . " requests left";
?>
{
"success": true,
"data": {
"plan": { "id": "pro", "name": "Pro", "billing": "monthly", "price": 15.0 },
"status": "active",
"can_make_requests": true,
"limits": { "requests": 7500, "requests_per_minute": 150 },
"usage": { "used": 1240, "remaining": 6260, "percent_used": 16.5, "successful": 1225, "failed": 15 },
"billing_period": { "start": "2026-10-01", "end": "2026-11-01" },
"cancel_at_period_end": false,
"end_date": null
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or inactive"
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
Get your plan, limits and how much of your quota you’ve used.
See Rate Limit for the limits of each plan and what counts against your quota.
https://fapihub.com/v2/account/usage/
- Free: calls don’t count against your quota and aren’t logged.
- Always available: keeps working when your quota is used up or your subscription has expired.
- Own limit: 60 calls per minute per API key.
- Auth: the same
ApiKeyheader as every other endpoint.
Call this endpoint before a large batch to check that
usage.remaining covers the number of images you plan to process.Response fields
| Field | Meaning |
|---|---|
plan.id | basic, pro, ultra, mega, per_usage or custom |
plan.billing | monthly, or lifetime for per-usage plans, which never reset. For lifetime plans billing_period is null. |
status | active, trial, over_limit, past_due, cancelled, expired or incomplete |
can_make_requests | Whether image requests are currently accepted |
limits.requests | Quota per billing period, or the lifetime total |
limits.requests_per_minute | Per-minute rate limit |
usage.used / usage.remaining / usage.percent_used | Quota consumed and left |
usage.successful / usage.failed | Breakdown of used; failed = counted 4xx errors |
billing_period.start / .end | Dates; the quota resets on end |
cancel_at_period_end | Whether the subscription is set to cancel at the end of the period |
end_date | Subscription end date or null |
curl "https://fapihub.com/v2/account/usage/" \
-H "ApiKey: your_api_key"
import requests
response = requests.get(
"https://fapihub.com/v2/account/usage/",
headers={"ApiKey": "your_api_key"},
)
data = response.json()["data"]
print(f"{data['usage']['remaining']} of {data['limits']['requests']} requests left")
const response = await fetch("https://fapihub.com/v2/account/usage/", {
headers: { "ApiKey": "your_api_key" },
});
const { data } = await response.json();
console.log(`${data.usage.remaining} of ${data.limits.requests} requests left`);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://fapihub.com/v2/account/usage/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["ApiKey: your_api_key"]
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
$data = $response["data"];
echo $data["usage"]["remaining"] . " of " . $data["limits"]["requests"] . " requests left";
?>
{
"success": true,
"data": {
"plan": { "id": "pro", "name": "Pro", "billing": "monthly", "price": 15.0 },
"status": "active",
"can_make_requests": true,
"limits": { "requests": 7500, "requests_per_minute": 150 },
"usage": { "used": 1240, "remaining": 6260, "percent_used": 16.5, "successful": 1225, "failed": 15 },
"billing_period": { "start": "2026-10-01", "end": "2026-11-01" },
"cancel_at_period_end": false,
"end_date": null
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "The provided API key is invalid or inactive"
},
"timestamp": "2026-10-27T10:00:00+00:00"
}
Authorizations
Your API key (looks like bg_live_sk_…). Create one in the dashboard at https://fapihub.com/dashboard/.