Skip to main content
Zeckta applies rate limits to protect platform stability and ensure fair usage across all customers. Rate limits are enforced on a per API key basis.

​
Transactions Per Second (TPS)

Each API key is assigned a maximum throughput measured in Transactions Per Second (TPS). For example:
API KeyTPS
OTP API Key10 TPS
Notifications API Key25 TPS
The configured TPS determines how many requests can be processed each second.

​
Viewing Your Limits

You can view the throughput limit assigned to each API key from the Zeckta Dashboard. Navigate to: 
API Keys menu under the Settings section.
The TPS column displays the current throughput configured for each key.

​
Rate Limit Headers

Every request includes standard rate limit headers.
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per second.
X-RateLimit-RemainingRemaining requests available in the current window.
X-RateLimit-ResetUnix timestamp when the current window resets.
Retry-AfterSeconds to wait before retrying (returned with 429 responses).
Example: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 94
X-RateLimit-Reset: 1781023456

​
Exceeding Limits

When your application exceeds the configured TPS limit, requests are rejected. Response: 
429 Too Many Requests
Example: 
{
  "success": false,
  "message": "Rate limit exceeded. Try again in 1 second."
}
The response includes: 
Retry-After: 1
indicating how long to wait before retrying.

​
Abuse Protection

Repeated rate limit violations may trigger temporary protection measures. In these cases, requests may continue to receive: 
429 Too Many Requests
with a longer retry period. Example: 
Retry-After: 3600

​
Implement Retries

Use exponential backoff when retrying failed requests.

​
Use Campaigns for Bulk Messaging

For large recipient volumes, prefer SMS Campaigns over individual message requests.

​
Monitor Throughput

Ensure your application does not consistently operate at its maximum TPS allocation.

​
Respect Retry Headers

Always honor the Retry-After header before retrying requests.

​
Need Higher Limits?

If your application requires additional throughput, contact Zeckta support to discuss higher TPS allocations.