Skip to main content

​
Overview

Get detailed usage statistics for your API account, including request counts, credits used, and usage by time period.

​
Request

​
GET Request

curl "https://api.gistmag.co.uk/usage?api_key=your_api_key_here"

​
POST Request

curl -X POST https://api.gistmag.co.uk/usage \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here"
  }'

​
Request Parameters

​
api_key
string
required
Your GistMag API key

​
Response

​
total_requests
number
Total number of API requests made
​
total_credits_used
number
Total credits consumed
​
requests_this_month
number
Number of requests made this month
​
credits_used_this_month
number
Credits used this month
​
subscription_tier
string
Your current subscription tier (free, pro, enterprise)
​
credits_remaining
number
Credits remaining in your account
​
usage_by_endpoint
object
Breakdown of usage by endpoint

​
Example Response

{
  "total_requests": 1523,
  "total_credits_used": 1523,
  "requests_this_month": 456,
  "credits_used_this_month": 456,
  "subscription_tier": "pro",
  "credits_remaining": 9544,
  "usage_by_endpoint": {
    "/generate": 1200,
    "/batch": 200,
    "/tts": 123
  }
}

​
Per-API-Key Usage

If you have multiple API keys, you can track usage per key. Each key’s usage is tracked independently.
Usage statistics are updated in real-time and reflect all requests made with your API keys.