Rate Limits

How many TrimLink API requests each plan gets per day, how the 24 hour window works, and what a 429 response looks like.

Daily limit by plan

PlanAPI requests per 24 hours
FreeNo API access
StarterNo API access
Pro1,000 requests
Growth10,000 requests
TeamsUnlimited
EnterpriseUnlimited
  • The limit is per account. Every API key on the account shares it.
  • Only requests made with an API key count. Requests from the TrimLink dashboard don't.
  • The window slides. Each request counts for 24 hours after it is made, so there is no fixed reset time. Room frees up as your oldest requests age out.
  • Requests refused with 429 are not counted. Requests that fail validation (400) are.
  • There is no separate per-minute burst limit, and responses carry no rate-limit headers.

When you hit the limit

The API answers 429 Too Many Requests with this body. The number is your plan's daily limit.

429 Response
HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "error": "Daily API rate limit reached (1000 requests). Resets in 24h.",
  "remaining": 0
}

A 429 is also returned if the limiter itself can't be reached, so retry it the same way. Plan quotas such as links per month, custom codes, QR codes and link edits are separate. Those return 403 with a limitKey, described on the errors page.

StatusMeaning
429Daily request limit reached. Wait for older requests to leave the 24 hour window.
403Your plan has no API access, the key lacks a scope, or a plan quota is used up.
401The API key is missing, invalid, expired or revoked.

Handling a 429

Back off and retry later. Since the window is 24 hours, a short retry loop rarely helps once the daily limit is spent. Queue the work and try again later.

async function trimlinkFetch(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const response = await fetch(url, options);
    if (response.status !== 429) return response;

    // No Retry-After header is sent, so back off on your own clock.
    const waitMs = Math.min(60_000 * 2 ** attempt, 15 * 60_000);
    await new Promise((resolve) => setTimeout(resolve, waitMs));
  }
  throw new Error('TrimLink daily API limit still reached, try again later');
}

Staying under the limit

  • Count your own calls, since responses don't report what is left.
  • Cache results you read often instead of asking again.
  • Send an Idempotency-Key when creating links so a retry doesn't make a second link. See the Links API.
  • Need more? Compare plans on the pricing page.