Skip to content
Manako Docs

Rate Limits

Rate limits applied to Manako endpoints.

Public API (/api/v1/*)

Section titled “Public API (/api/v1/*)”

Two layers of limits apply; exceeding either returns HTTP 429.

ScopeLimit
Source IP address300 requests / min
API key (per plan)Free: 60 / Pro: 180 / Business: 300 requests / min

When the limit is exceeded

Section titled “When the limit is exceeded”
  • Status code 429 with error code RATE_LIMITED
  • The Retry-After response header contains the number of seconds to wait
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "status": 429
  }
}

Client guidelines

Section titled “Client guidelines”
  • On 429, wait for Retry-After seconds before retrying
  • Consider webhook subscriptions instead of polling — event-driven integration drastically reduces API calls

Heartbeat Ping Endpoint

Section titled “Heartbeat Ping Endpoint”

The ping URL for Heartbeat monitors has its own limit, separate from the Public API:

  • 60 requests / min per source IP address
  • Exceeding it returns 429 (the ping is not recorded)