Limites da API

Quantas requisições a API aceita e o que acontece ao passar do limite.

LimiteValor
Requisições por usuário (chamadas com token de login)500 por minuto
Requisições por endereço IP (chamadas sem token)500 por minuto
Requisições por chave de API (API de e-mail transacional)600 por minuto
Requisições por endereço IP na API de e-mail transacional1.200 por minuto
Tamanho do corpo da requisição1 MiB na maioria das rotas; maior nas rotas de envio de arquivos e de importação

A contagem é feita em janelas fixas de 60 segundos. Ao passar do limite, a API responde 429 Too Many Requests:

{
  "error": true,
  "message": "Rate limit exceeded",
  "expected": {
    "retry_after": "17s"
  }
}

Espere o tempo de retry_after antes de repetir. Na API de e-mail transacional, a resposta traz o código api_key_rate_limited, o cabeçalho Retry-After e os segundos em details.retry_after_seconds.

Algumas rotas, como o login, têm limites próprios. A lista completa está no guia Limites de requisição.