Mokapen API Documentation

Per-minute limit

Standard API clients are limited to 60 requests per minute per authenticated client or user.

Mobile clients sending the header X-Client: mobile may receive a higher limit (200 requests per minute).

HTTP/1.1 429 Too Many Requests

{
  "status": false,
  "message": "Too Many Requests",
  "max_attempts": 60,
  "remaining": 0,
  "retry_after": "45 seconds"
}

Daily quota (plan-based)

Each organization has a daily API request quota determined by its Mokapen plan. The quota applies per organization per calendar day (UTC).

When the daily quota is exceeded, the API returns 429 Too Many Requests with a quota exceeded message.

HTTP/1.1 429 Too Many Requests

{
  "message": "Quota exceeded",
  "API daily request limit exceeded.\n": 2000
}

Best practices

• Cache responses where possible instead of polling frequently.
• Implement exponential backoff when receiving 429 responses.
• Use webhooks for event-driven integrations instead of repeated polling.
• Request only the scopes you need.