⏱️ Rate Limits in Dymo API
Learn to understand the rate limit system.
Rate Limit Headers
Our API uses rate limits to prevent abuse and ensure fair usage. All authenticated and unauthenticated requests may return rate limit headers in the response.
🔁 Retry Policy
If you exceed your plan’s limit, the API will respond with a 429 Too Many Requests status code.
| Header | Description | When Sent |
|---|---|---|
retry-after | Time to wait before making a new request (in seconds). | Only on status 429 |
📦 Request Limits
These headers refer to your allocation per minute of requests (Requests Per Minute).
| Header | Description |
|---|---|
X-Ratelimit-Limit-Requests | Total number of requests per minute allowed by your plan. |
X-Ratelimit-Remaining-Requests | Requests remaining before reaching the minute limit limit. |
X-Ratelimit-Reset-Requests | Time until the minute quota resets. Example: 2m59.56s. |
🔢 Credit-Based Limits
Some endpoints or features use a credit-based system to meter usage more precisely.
| Header | Description |
|---|---|
X-Credits-Remaining | Total credits remaining in your plan balance. |
X-Credits-Consumed | Number of credits used by the current request. |
These headers are included in responses where credit usage is relevant. You can use this data to monitor user balances or alert them when nearing usage limits.
⚡ Token Limits
These headers refer to your token usage per minute (Tokens Per Minute), used in generative features (e.g., AI responses).
| Header | Description |
|---|---|
X-Ratelimit-Limit-Tokens | Max tokens per minute allowed by your plan. |
X-Ratelimit-Remaining-Tokens | Tokens remaining for the current minute. |
X-Ratelimit-Reset-Tokens | Time until token quota resets. Example: 7.66s. |
🔓 Unlimited Usage
Some plans may include unlimited access to certain resources. In those cases, the value of the limit headers will be:
X-Ratelimit-Limit-Requests: unlimited
X-Ratelimit-Remaining-Requests: unlimited
X-Ratelimit-Reset-Requests: unlimited
X-Ratelimit-Limit-Tokens: unlimited
X-Ratelimit-Remaining-Tokens: unlimited
X-Ratelimit-Reset-Tokens: unlimited
unlimited, you will not receive a 429 error from that specific rate type.By checking these headers, you can dynamically adjust your requests or notify users about their usage status.