Back to Documentation
Rate Limits
Understand the usage limits and quotas for your account based on your subscription tier.
Subscription Tiers
| Feature | Free Tier | Pro Tier |
|---|---|---|
| Notifications | 100 lifetime | 1,000 per month |
| Applications | 3 maximum | 10 maximum |
| Quota Reset | Never (lifetime) | 1st of each month, 00:00 UTC |
Free Tier
- 100 notifications lifetime (not monthly)
- Maximum of 3 applications
- Once the lifetime limit is reached, you must upgrade to continue receiving notifications
Pro Tier
- 1,000 notifications per month
- Up to 10 applications
- Counter resets automatically on the 1st of each month at 00:00 UTC
Viewing Your Usage
The Applications screen in the mobile app displays two stat cards showing your current usage:
- Messages Sent: Shows current usage vs limit (e.g., "42 of 100 lifetime" or "150 of 1,000 per month")
- Applications Created: Shows created apps vs maximum allowed
Rate Limit Details Toast
Tap on the "messages sent" stat card to see detailed rate limit information:
Free Users
Shows "Lifetime Limit" with "X of 100 notifications used"
Pro Users
Shows reset date (e.g., "Resets Mar 1, 00:00 UTC") and countdown timer
Rate Limit API Response
When you exceed your rate limit, the API returns a 429 status code:
{
"success": false,
"error": "Monthly message limit exceeded",
"limit": 100,
"received": 100
}For free users, the error message will indicate "Lifetime message limit exceeded" instead.