Your usage
F
GET
/v1/usage
Your calls, limits and reset window
Your calls today and this period against your plan limits, and when the window resets. The same figures your account page shows.
Plan
This endpoint needs Free key. It works on the free key, which reads yesterday, as one whole day.
Returns
data.plan
string
Plan.
data.per_minute_limit
integer
Per minute limit.
data.per_day_limit
integer
Per day limit.
data.used_today
integer
Used today.
data.remaining_today
integer
Remaining today.
data.resets_at
string
Resets at.
meta.data_as_of
string
When the data behind this answer was last brought up to date.
meta.request_id
string
This request's id, to quote to support.
Request
curl "https://api.footballsoccerapi.com/v1/usage" \ -H "X-API-Key: $FSAPI_KEY"
const res = await fetch("https://api.footballsoccerapi.com/v1/usage", { headers: { "X-API-Key": process.env.FSAPI_KEY } }); const { data, meta } = await res.json();
import os, requests r = requests.get( "https://api.footballsoccerapi.com/v1/usage", headers={"X-API-Key": os.environ["FSAPI_KEY"]}, ) data = r.json()["data"]
$ch = curl_init("https://api.footballsoccerapi.com/v1/usage"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: {$key}"], ]); $data = json_decode(curl_exec($ch), true)["data"];
Example response
A real row from the archive, fetched when this page rendered. Run it against your own key below.
200 OK
application/json
{
"data": {
"plan": "free",
"per_minute_limit": 60,
"per_day_limit": 50,
"used_today": 17,
"remaining_today": 33,
"resets_at": "2026-10-30T00:00:00Z"
},
"meta": {
"data_as_of": "2026-10-29T04:32:57Z",
"request_id": "01J9QW3C7M4KX2VB"
}
}
Run it live
Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.