Usage & Limits
Usage & Limits
Account → Usage & Limits shows how much of every limit your account uses, on one page. It has two tabs:
- Usage — the monthly usage (requests, data transfer and Iris tokens), the Limits table of the resources you create, and your lifetime totals: requests served, data transferred and tunnel sessions.
- Plan capabilities — what your plan includes and the limits on your account.
Every limit on the page is drawn the same way, as a ring, and the sidebar link carries a badge when a limit is close. Will I hit a limit? at the top asks Iris.
One ring for every limit
Each limit is a ring that fills as you use it. One rule decides its colour and status, everywhere:
| Status | When |
|---|---|
| Good | Below 80% of the limit. The ring is blue. |
| Approaching limit | From 80% of the limit. The ring turns amber. |
| Limit reached | At 100%. The ring is full and red. |
| Over the limit | Past the limit, for example after a move to a plan with a lower one; the page says by how much (Over by 2). Downgrade grace says what you keep. |
| Unlimited | No limit: an empty ring with ∞ and what you use. |
| Not included | Your plan doesn’t include it: a dashed grey ring. |
The dashboard home’s Plan usage card, Billing and AI activity draw their limits with the same ring and the same rule, so a limit reads the same wherever you see it.
Monthly usage
The Monthly usage cards on the Usage tab show what starts again each month. Each card has a large ring, what you’ve used of the limit and its status:
- Requests and Data transfer count your current billing period and start again on your renewal date. At the limit, your endpoints stop serving until your next billing month.
- Iris tokens start again on the 1st of each month. At the limit, Iris stops answering until they do.
The forecast
When your pace would use up your requests or data transfer before the billing period ends, the card says when, for example At this pace you’ll hit your request limit in about 3 days. It reads tomorrow or today when it’s that close. The pace is what you used over the last 7 days.
At the limit, the card says what happens there; past it, also by how much: Over by 685,559. A card that needs attention has the way to more room on its last line (Request increase).
The Limits table
Below the monthly usage, Limits lists every resource you create that has a limit — endpoints, tunnels, custom domains, databases, team members and more — most urgent first: limits passed and reached, then the rest by how much of the limit you use, then the unlimited ones and the ones your plan doesn’t include. Its header counts them: 1 limit reached, 1 approaching, or All limits good.
Each row shows the resource, its status, its ring with what you use of the limit, What happens at the limit, and an action. Reaching a limit stops only new ones, and the column says exactly what stops, for example:
- Endpoints: New endpoints can’t be created
- Tunnels: New tunnels can’t connect
- Team members: New members can’t be invited
- Cron jobs: New cron jobs can’t be added
What you already have keeps working. An unlimited row reads No limit on your plan, and a row your plan doesn’t include reads Not available on your plan.
| Resource | Status | Usage | What happens at the limit | Action |
|---|---|---|---|---|
| Cron jobs | Limit reached | 20 / 20 | New cron jobs can't be added | Request increase |
| Dedicated ports | Approaching limit | 8 / 10 | New dedicated ports can't be reserved | Request increase |
| Databases | Good | 3 / 10 | New databases can't be created | Request increase |
| Dedicated IPs | Good | 0 / 6 | New dedicated IPs can't be requested | Request increase |
| Traffic policies | Unlimited | 4 | No limit on your plan | |
| SSO configurations | Not included | — | Not available on your plan |
Request increase
The last column of the Limits table, and the last line of a monthly card that needs attention, is the way to more room. Where another plan raises that limit it reads Upgrade and opens your plans. Otherwise it reads Request increase: it opens a new support ticket in a new tab, with the subject (Limit increase: Cron jobs), the category and a message with your current usage and the limit already filled in. Add why you need more and submit it.
The link is in the brand colour on a row that needs attention, and grey on a good one. Unlimited rows and rows your plan doesn’t include have none.
Create a support ticket
Tell us what's going on and our team will get back to you. The more detail you share, the faster we can help.
The sidebar badge
The Usage & Limits link in the sidebar carries a badge on every page, so you see a limit coming before a create fails:
- a red count of the limits reached or passed, in the monthly usage and the Limits table together;
- an amber dot when none is reached but some are approaching.
Hover the badge for the counts, e.g. 1 limit reached, 2 approaching. With every limit good, there’s no badge. It counts the same limits the page shows.
Will I hit a limit?
Not sure where you’ll land this month? Click Will I hit a limit? at the top of the page. Iris reads your usage and limits, tells you which limits you’re closest to, and projects your requests and data transfer to the end of the billing period at your recent pace.
Your own scripts read the same numbers from the API: GET /v1/account/usage has this period’s use, the last 7 days’ pace and a count for every limit, and GET /v1/account/plan has the limits themselves.
curl "https://api.ngris.com/v1/account/usage" \
-H "X-API-KEY: <your_api_key>"{
"current": {
"requests_used": 8512000,
"bandwidth_used": 39728447488
},
"limits": {
"request_limit": 10000000,
"bandwidth_limit": 107374182400
},
"percent_used": {
"requests": 85.1,
"bandwidth": 37
},
"period": {
"start": "2026-10-18T00:00:00Z",
"end": "2026-11-18T00:00:00Z"
},
"last_7_days": {
"requests": 3472000,
"bandwidth": 15032385536
},
"counts": {
"cron_jobs": 20,
"dedicated_ports": 8,
"managed_database": 3,
"dedicated_ips": 0
}
}