Monthly check quota exceeded

Type: https://plotdr.ch/problems/quota-exceeded
HTTP status: 429
Content type: application/problem+json

What it means

The Free plan includes 200 checks per calendar month, counted in UTC. Creating the requested checks would take the organization past that limit, so none were created.

The count covers the checks created this month plus the checks still owed by batches submitted this month that are pending or running. A batch is counted in full when you submit it: if all of its items do not fit in what is left, the whole batch is refused.

This problem can come from POST /v1/checks, POST /v1/plots/{plot_id}/checks and POST /v1/batches.

You will not receive it with an API key. API keys require the API Pro plan, and the Pro and API Pro plans have no monthly check limit.

Typical causes

The organization is on the Free plan and has used its checks for the month.
A batch is larger than the checks left this month.

What to do

Wait for the next calendar month, when the count starts again. The response has no Retry-After header, because retrying sooner returns the same error.
Submit a smaller batch that fits in the checks left.
Upgrade to Pro or API Pro under Billing in the dashboard. See Pricing.

This is not the per-minute rate limit. A rate-limited request also answers 429, but with "type": "about:blank" and a Retry-After header; see rate limits.

Example

POST /v1/batches with 50 plots from a Free organization that has 180 checks this month.

{
  "type": "https://plotdr.ch/problems/quota-exceeded",
  "title": "Monthly check quota exceeded",
  "status": 429,
  "detail": "Free plan is limited to 200 checks per month (180 used). Upgrade to Pro for unlimited screening.",
  "instance": "/v1/batches"
}

See also: all problem types, theerror handling guide, and theAPI reference.