Unify Logo Footer.svg
API Manager
Logo
Usage Quota Policy

Usage Quota Policy

Logo

3 mins READ

Limit the total number of API requests a client profile can make over a defined period — daily, monthly, or any custom duration.

Overview

Usage Quota Policy limits the total number of API requests a client profile can make over a defined time period — for example, 10,000 requests per day or 100,000 per month. Unlike a rate limit (which controls bursts), a usage quota enforces a longer-term consumption cap, making it suitable for enforcing usage tiers and fair-use agreements.

usage.png
usage.png

Field Reference

Field

Description

Policy Name *

A unique identifier used across logs, dashboards, and API group configurations.

Tags

Custom labels to organize and filter the policy by environment, team, or functionality.

Duration *

The length of time over which API usage is tracked. For example, 1 with Unit Days defines a daily quota.

Unit *

The time unit for the Duration field. Options: Minutes, Hours, Days, Months.

Number of Requests *

The maximum number of requests allowed per client profile within the defined period. Once reached, further requests are denied until the quota resets.

usage-1.png
usage-1.png

How It Works

  1. Request arrives — The gateway receives the request and identifies the client profile (API key, user ID, or IP).

  2. Quota check — The system retrieves how many requests the client has already made in the current quota period.

  3. Limit evaluation — If the count is below the quota, the request is allowed and the count increments. If at or above the limit, the request is rejected.

  4. Quota reset — At the end of the configured period, the usage counter resets and the client can make requests again.

  5. Error response — Rejected requests receive an error indicating the usage limit has been reached.

Attaching to an API Group

Once a Usage Quota Policy is created, attach it to one or more API Groups from the group's policy settings. Multiple policies can be applied to a single group; drag them into the desired execution order.

Notes

  • Usage quotas are tracked per client profile, so one client exhausting their quota does not affect other clients.

  • Apply both a Rate Limiting Policy (burst control) and a Usage Quota Policy (total cap) when you need to govern both traffic spikes and overall consumption.

  • The counter resets at the boundary of the configured period — a daily quota resets at the start of the next day, not 24 hours after the client's first request.

  • Monitor quota usage from the API Manager Insights dashboard to identify clients approaching their limit before they hit it.

FAQs

What is the difference between a Usage Quota and a Rate Limiting Policy?

A Rate Limiting Policy controls short-window traffic bursts (e.g., 100 requests per minute), while a Usage Quota controls total consumption over a longer period (e.g., 10,000 requests per day). Use both together for complete traffic governance.

Can the quota be different for different clients?

Yes. Create separate Usage Quota Policies with different limits and attach them to different client access profiles, giving you per-client tier enforcement.

What does the client receive when their quota is exceeded?

An error response is returned to the client indicating their usage limit has been reached. The backing automation is not invoked for rejected requests.

When does the quota counter reset?

The counter resets at the end of the configured duration period — for example, at the start of the next calendar day for a daily quota, or the start of the next calendar month for a monthly quota.