Skip to main content
GET/public/usage

Get current usage and quota information.

Example Request

curl https://api.promptomize.app/api/v1/public/usage \
  -H "X-API-Key: pk_live_your_api_key"

Response

{
  "tier": "API_STARTER",
  "status": "ACTIVE",
  "quota": {
    "used": 450,
    "limit": 1000,
    "remaining": 550,
    "periodStart": "2024-01-01T00:00:00Z",
    "periodEnd": "2024-02-01T00:00:00Z"
  },
  "rateLimit": {
    "requestsPerMinute": 60
  },
  "features": [
    "1,000 requests/month",
    "60 requests/minute",
    "Email support"
  ]
}

Response Fields

FieldDescription
tierCurrent subscription tier
statusSubscription status (ACTIVE, PAST_DUE, etc.)
quota.usedRequests used in current period
quota.limitTotal requests allowed (or "unlimited")
quota.remainingRequests remaining in period
quota.periodEndWhen the current period ends
rateLimit.requestsPerMinutePer-minute rate limit