Rate Limits

Wie viele Anfragen Sie stellen dürfen, wie Sie sehen, wo Sie stehen, und wie Sie sauber drosseln.

Limits#

Das Limit pro Unternehmen gilt für alle Schlüssel Ihres Unternehmens zusammen. Schreibvorgänge (POST, PATCH, DELETE) zählen zusätzlich zum Schreiblimit. Die Fenster sind fest: Ein Minutenlimit beginnt zu jeder vollen Minute neu, das Tageslimit um Mitternacht UTC. Auch eine abgelehnte Anfrage zählt mit. Brauchen Sie dauerhaft mehr? Wenden Sie sich an den Support.

Aufwändige Aktionen haben ein eigenes, knapperes Limit: ein Angebot oder eine Rechnung per E-Mail versenden, ein PDF abrufen, eine Nachricht im Posteingang senden, eine Bewertungsanfrage versenden, einem Kunden eine Nachricht zu einem Termin senden und eine Testnachricht an einen Webhook-Endpunkt senden.

Daneben gelten einige Grenzen, die nichts mit dem Tempo Ihrer Anfragen zu tun haben, die Sie aber ebenfalls als 429 rate_limited zu sehen bekommen:

• höchstens 200 Uploads (Anhänge und Arbeitsauftragsfotos) pro Unternehmen und Tag, als 429 rate_limited;
• höchstens 20 Nachrichten pro Stunde in derselben Unterhaltung, als 429 rate_limited;
• höchstens 250 ausgehende Nachrichten und E-Mails an Kunden pro Unternehmen und Stunde (Posteingang, Angebots- und Rechnungs-E-Mail zusammen) und höchstens 20 Versendungen desselben Dokuments je 24 Stunden. Im Posteingang erhalten Sie dafür 429 rate_limited; beim Versenden eines Angebots oder einer Rechnung per E-Mail 403 forbidden.

Header#

Jede Antwort zeigt Ihnen, wo Sie stehen:

Bei einem 429#

Ein 429 rate_limited hat einen Header Retry-After mit der Anzahl Sekunden, die Sie warten müssen. Das Feld limit in der Antwort nennt das Limit, das Sie erreicht haben.

async function request(url, options, attempt = 0) {
  const response = await fetch(url, options);

  if (response.status === 429 && attempt < 5) {
    const seconds = Number(response.headers.get('Retry-After') ?? 1);
    await new Promise((resolve) => setTimeout(resolve, seconds * 1000));

    return request(url, options, attempt + 1);
  }

  return response;
}

Zuletzt aktualisiert am 21. September 2026