Usage

Check your current month’s usage, quota limits, rate limits, tier, and dataset slot usage.

Request

GET /v1/usage

Example

curl -s "https://api.terranode.co/v1/usage" \
  -H "x-api-key: YOUR_API_KEY" | jq .

Response

{
  "tier": "free",
  "requests": {
    "used": 0,
    "limit": 50000,
    "resets_at": "2026-04-01T00:00:00.000Z"
  },
  "rate_limit": {
    "per_second": 10
  },
  "datasets": {
    "used": 0,
    "limit": 1,
    "max_features": 500
  }
}

Fields

Field	Description
tier	Your current tier (free). Pro and Scale tiers coming soon.
requests.used	Requests consumed this billing period
requests.limit	Monthly request quota
requests.resets_at	When the quota resets (1st of each month, midnight UTC)
rate_limit.per_second	Maximum requests per second
datasets.used	Custom datasets currently active
datasets.limit	Maximum custom dataset slots for your tier
datasets.max_features	Maximum features per custom dataset for your tier