Skip to content

Limits and rate limit messages

Four different limits exist and they behave differently. Find yours by what you were doing.

You were The limit Fix
Issuing an invoice in the app Monthly invoice allowance Upgrade, or wait for the month to roll over
Calling the API rapidly 200 requests a minute Slow down and retry
Writing a lot through the API Fair use, when Clix has switched it on Contact support
Using the free public tools 10 a day, or 100 a month Sign in, or upgrade

The monthly invoice allowance

Your plan allows a number of invoices per calendar month: 15 on Free, 200 on Pro, unlimited on Business.

There is a 10% grace above the limit, rounded up. On Free the 17th invoice is the last one allowed; on Pro, the 220th.

Nothing is deleted when you reach it. You cannot create new invoices; everything else keeps working. The allowance resets at 00:00 on the 1st of the month, Riyadh time.

To keep issuing now, upgrade from Subscription. Only one upgrade starts at once, before your transfer arrives: the first move from Free to Pro, Monthly, once per organisation. Any other upgrade starts when your transfer reaches Clix, within one working day. See Upgrade to a paid plan.

What counts

Every invoice created in the month, by its issue date: standard and simplified invoices, credit notes and debit notes. An invoice ZATCA rejected still counts, and so does the corrected copy that replaces it. Drafts and previews do not count.

API rate limit — 429

{ "detail": "Rate limit exceeded. Please try again later.",
  "limit": 200, "window": 60, "retry_after": 12 }

200 requests a minute per API key, in a fixed 60-second window. Each key has its own count, separate from people using the app. A person signed in to the app also has 200 a minute.

Wait retry_after seconds and continue. Better: read X-RateLimit-Remaining on every response and pace yourself before you hit zero. Retrying instantly makes it worse.

This limit is not about your plan and upgrading will not raise it.

Fair use — 403

{ "code": "fair_use_limit",
  "detail": "Your organisation has reached its fair-use limit for this month. Viewing and downloading still work. Contact support to continue." }

A guard on successful writes: creating, changing and deleting. It is off unless Clix switches it on for the platform or for your organisation. When on, it refuses writes after your plan's monthly allowance plus 10%. Clix sets the allowance per plan and does not publish it; Business has no limit. Reading, downloading and viewing keep working.

It is a 403, not a 429. Retrying will not clear it, and it resets on the 1st of the month, Asia/Riyadh time. Talk to support@goclix.ai; this is a conversation, not a wall.

Public tools limits

The free tools — QR scanning, ZATCA validation, VAT calculation — are metered separately and do not touch your invoice allowance:

Caller Allowance
Not signed in 10 a day per IP address, resetting at midnight UTC
Free plan 100 a month
Paid plans, including Pro while its first transfer is on the way Not metered

Uploads there are capped at 5 MiB.

A share link expires after 30 days and serves at most 60 views an hour. A link that has stopped working has probably expired — issue a new one from the invoice.

Checking where you stand

  • In the app: the dashboard names your plan; Subscription shows the current plan and billing date.
  • Through the API: GET /api/usage/current/ returns invoices_used, invoices_limit and invoices_allowed. Branch on invoices_allowed before a batch run.

api_calls_used always reads 0

Those fields are frozen at zero for compatibility; API calls are not metered monthly. Use the invoice counters. See Usage and quotas.