Rate Limiting & Daily Limits

Rate Limiting

All API endpoints are rate-limited to 60 requests per minute per reseller. This applies to all endpoints including the token endpoint.

If you exceed the rate limit, you will receive:

// Status: 429
{
  "message": "Too many requests."
}

Recommendation: Add a small delay between rapid sequential requests. If you receive a 429 response, wait a few seconds before retrying.

Daily Spending Limit

Each reseller has a daily spending limit (in LYD) configured during onboarding. This is a shared cap across both voucher generation and deposits combined.

For example, if your daily limit is 5,000 LYD:

Action	Amount	Used Today	Remaining
Generate 100 LYD voucher	100	100	4,900
Generate 100 LYD voucher	100	200	4,800
Deposit 500 LYD	500	700	4,300
Generate 50 LYD voucher	50	750	4,250

The limit resets daily at midnight.

When the limit is exceeded

Both the voucher generation and deposit endpoints return a 422 response with details:

{
  "message": "Daily limit exceeded.",
  "daily_max_amount": 5000,
  "used_today": 4950,
  "remaining": 50,
  "requested": 100
}

Field	Description
daily_max_amount	Your configured daily limit in LYD
used_today	Total amount used today (vouchers + deposits)
remaining	How much you can still use today
requested	The amount you tried to use in this request

Increasing your limit

Contact the Academia team to request a daily limit increase.