API

GET /v1/usage

Check your current credit balance, plan status, and usage breakdown.

Request

GET https://api.coolcoding.co.uk/v1/usage

Example Request

curl https://api.coolcoding.co.uk/v1/usage \
  -H "Authorization: Bearer cc-YOUR_API_KEY"

Python:

import requests

response = requests.get(
    "https://api.coolcoding.co.uk/v1/usage",
    headers={"Authorization": "Bearer cc-YOUR_API_KEY"}
)
print(response.json())

Response

{
  "plan": "Builder",
  "credits_used": 1240,
  "credits_remaining": 760,
  "credits_total": 2000,
  "resets_at": "2026-06-01T00:00:00Z",
  "breakdown": {
    "ingest": 640,
    "signals": 310,
    "alerts": 140,
    "score": 90,
    "report": 60
  },
  "request_id": "req_1c3e9a"
}

Rate limit: 10 requests per 10 minutes on all plans.

Error Responses

Code	Meaning
400	Bad Request — missing or invalid parameters
401	Unauthorized — API key missing or invalid
429	Too Many Requests — rate limit exceeded
432	Plan limit exceeded — upgrade your plan
500	Internal Server Error

429 example:

{
  "error": "Rate limit exceeded. Please reduce request frequency.",
  "retry_after": 60
}

Implement retry logic that respects the retry-after header value.