Globale limieten

Brevo beperkt API-verzoeken per endpoint. Elke limiet is een aantal verzoeken per seconde (RPS), per uur (RPH) of beide. De cijfers hieronder komen van de pagina met rate limits van Brevo, gecontroleerd op 7 oktober 2026. Controleer die pagina voordat je een grote taak plant.

Niveaus van rate limits

Limieten per niveau

Als een endpoint zowel een RPS- als een RPH-limiet heeft, blijf dan onder beide.

Headers voor rate limits

Endpoints met een rate limit geven deze headers terug:

HTTP/1.1 200 OK
x-sib-ratelimit-limit: 1000
x-sib-ratelimit-remaining: 750
x-sib-ratelimit-reset: 1

Beschrijving van de headers

• x-sib-ratelimit-limit: toegestane verzoeken in het huidige venster
• x-sib-ratelimit-remaining: resterende verzoeken in het huidige venster
• x-sib-ratelimit-reset: tijd tot het venster wordt gereset, meestal in seconden

Brevo beschrijft deze headers op zijn pagina over rate limit-headers.

Gebruik monitoren

Huidig gebruik controleren

const checkRateLimit = async () => {
  const response = await fetch('https://api.brevo.com/v3/account', {
    headers: { 'api-key': process.env.BREVO_API_KEY }
  });

  console.log({
    limit: response.headers.get('x-sib-ratelimit-limit'),
    remaining: response.headers.get('x-sib-ratelimit-remaining'),
    resetInSeconds: Number(response.headers.get('x-sib-ratelimit-reset'))
  });
};

Omgaan met rate limits

Exponentiële backoff

const makeRequestWithBackoff = async (url, options, maxRetries = 3) => {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);

    if (response.status !== 429) return response;

    const resetSeconds = Number(response.headers.get('x-sib-ratelimit-reset') || 1);
    const delay = Math.max(resetSeconds * 1000, 1000 * Math.pow(2, i));

    console.log(`Rate limited. Waiting ${delay}ms before retry ${i + 1}`);
    await new Promise(resolve => setTimeout(resolve, delay));
  }
  throw new Error('Rate limit retries exhausted');
};

Als je steeds tegen de limieten aanloopt

1. Spreid verzoeken gelijkmatig: een limiet van 1.000 RPS staat alleen tot 60.000 verzoeken per minuut toe als ze gelijkmatig zijn gespreid.
2. Batch en cache: gebruik bulk-endpoints en vermijd het opnieuw lezen van gegevens die je al hebt.
3. Gebruik webhooks voor statistieken: ontvang events in plaats van statistiek-endpoints te pollen.
4. Overweeg een hoger niveau: het geavanceerde en het uitgebreide niveau horen bij Professional- en Enterprise-abonnementen.