Skip to main content

429 Rate Limit

Understanding this error screen on your device.

Written by Ryan Kulp

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 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). That endpoint has its own limit of 6 requests per minute for each API Key, also during the first 24 hours. Past it, the server answers with HTTP 429 and no screen until the minute is up.

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

Rate Limit Details

For devices pinging the TRMNL server:

  • No limit for the first 24 hours after a device is set up

  • 40 requests within 5 minutes after that

For webhooks, rate limits are detailed on the webhook docs.

How to Resolve

When your API requests trigger a Rate Limit, the response content will instruct your device to sleep for 5-15 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?