Skip to main content

429 Rate Limit

Understanding this error screen on your device.

Ryan avatar
Written by Ryan
Updated this week

Are you seeing this on your TRMNL?

A 429 Rate Limit means "too many requests," which could be caused by a few scenarios.

  1. You've just set up your device, and it was having trouble connecting to your local WiFi. The TRMNL firmware automatically retries several times in a row, which might breach our limit.

  2. You are sharing a single API Key across multiple BYOD / DIY devices. Pending your use case, it may be better to acquire more licenses or leverage the /current_screen endpoint instead (docs).

  3. You are repeatedly clicking the button on the back of your TRMNL within a short period of time.

Rate Limit Details

  • 10x requests within 1 minute for new devices actively being set up

  • 10x requests within 5 minutes for existing (completed setup) devices

How to Resolve

When your API requests trigger a Rate Limit, the response content will instruct your device to sleep for 5-10 minutes before trying again.

This ensures the rate limit is resolved automatically on your next organic refresh. Alternatively you can turn your device off for 5 minutes, then back on.

Did this answer your question?