Rate Limits

To ensure the stability and reliability of the Melon platform for all users, our external API is rate-limited. The specific rate limits applied to your API keys depend entirely on your active pricing tier.

API Plans and Quotas

Note: Daily quotas reset at Midnight (00:00) UTC.

Handling Rate Limits

When your application exceeds its allowed request quota, the API will respond with an HTTP 429 Too Many Requests status code.

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your daily quota of 100 requests. Please upgrade your plan."
  }
}

Best Practices

To prevent hitting rate limits unexpectedly:

1. Use Webhooks: Instead of repeatedly polling the /api/v1/verification/:id/status endpoint to check if a verification has finished, set up Webhooks to have Melon push the status updates directly to your server.
2. Handle 429s Gracefully: Ensure your application can gracefully handle 429 responses by delaying and retrying the request if appropriate, or by notifying administrators that an upgrade may be necessary.
3. Monitor Usage: You can monitor your current API usage directly from the Analytics section of your Dashboard.