Usage & Limits

Check how many renders you've used this month and how many remain.

How limits work

Each plan includes a monthly render limit. Every successful call to any render endpoint (/v1/render, /v1/render/fast, /v1/render/full, /v1/screenshot, /v1/pdf) counts as one render. Batch requests count as N renders (one per item).

The counter resets on the 1st of each month. When the limit is reached, all render endpoints return 429 Too Many Requests until the period resets or you upgrade.

ℹ️

Plans with full_renders.limit: -1 do not have access to /v1/render/full. Upgrade to the $49/month plan or higher to unlock it.

Check current usage

GET/v1/usage

Returns usage counters for the current billing period.

Response

JSON

{
  "period": {
    "start": "2026-05-01T00:00:00Z",
    "end":   "2026-06-01T00:00:00Z"
  },
  "renders": {
    "used":      342,
    "limit":     2000,
    "remaining": 1658
  },
  "full_renders": {
    "used":      0,
    "limit":     -1,
    "remaining": null
  }
}

Field	Description
`period.start` / `period.end`	UTC timestamps for the current billing period.
`renders.used`	Total render calls made this period across all endpoints.
`renders.limit`	Monthly render cap for your plan.
`renders.remaining`	Renders left before hitting the 429 limit. `-1` means unlimited.
`full_renders.limit`	`-1` = plan does not include `/v1/render/full`. Positive value = monthly cap.
`full_renders.remaining`	`null` when not available on plan, otherwise renders remaining.

Examples

Check usage

cURL

curl https://api.starkrender.com/v1/usage \
  -H "x-api-key: YOUR_API_KEY"

Check before a large batch (JavaScript)

JavaScript

const res  = await fetch('https://api.starkrender.com/v1/usage', {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { renders } = await res.json();

if (renders.remaining < batchSize) {
  console.error('Not enough renders remaining');
} else {
  // proceed with batch
}