Usage Monitoring & Limits

Track email usage and rate limits via the dashboard and API.

Monitor your sending activity to avoid unexpected limit errors and plan for scale.

Dashboard

The Notify dashboard shows:

• Current monthly usage vs. plan limit
• Hourly rate limit status
• Time until rate limit reset

Usage API

Check usage programmatically:

curl -X GET https://notify.cx/api/email/usage \
  -H "x-api-key: your_api_key"

Response:

{
  "success": true,
  "data": {
    "email_send_per_hour": {
      "limit": 100,
      "used": 73,
      "resets_in": 1680
    },
    "emails_sent_this_month": {
      "limit": 10000,
      "used": 4432,
      "resets_on": "2025-04-30T23:59:59Z"
    }
  }
}

Plan limits reference

See Usage Limits FAQ for rate limit details and upgrade options.

Rate limit headers

API responses include limit information in headers:

Handling limit errors

When you exceed a limit, the API returns 429 Too Many Requests:

{
  "success": false,
  "error": "Monthly email limit exceeded",
  "code": "MONTHLY_LIMIT_EXCEEDED"
}

Handle gracefully in your application:

1. Detect 429 or the specific error code
2. Back off or queue remaining sends
3. Resume when limits reset — check resets_in or resets_on from the usage API

Upgrading

Visit notify.cx/pricing to upgrade. For custom volume, contact hello@notify.cx.

Next steps

• Usage Limits FAQ
• Usage API Reference
• Sending Emails