Rate limits

#What is the limit?

#Reading the headers

RateLimit-Reset and Retry-After are both seconds until the window resets, not a timestamp. There are no X-RateLimit-* headers — only the unprefixed standard ones.

#What happens when I exceed it?

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded for this company.",
    "request_id": "b7c1e4a2-..."
  }
}

Returned with HTTP 429. Nothing is processed, and no credit is consumed.

#How should I handle it?

Exponential backoff with jitter. The jitter matters: without it, several workers that hit the limit together will retry together and hit it again.

async function callWithRetry(request, attempts = 5) {
  for (let attempt = 0; attempt < attempts; attempt += 1) {
    const response = await request();
    if (response.status !== 429) return response;

    // Prefer the server's own reset hint; fall back to exponential backoff.
    const reset = Number(response.headers.get('RateLimit-Reset'));
    const backoff = Number.isFinite(reset) && reset > 0
      ? reset * 1000
      : 2 ** attempt * 1000;

    await new Promise((r) => setTimeout(r, backoff + Math.random() * 500));
  }
  throw new Error('Rate limit retries exhausted');
}

#How do I process a large batch?

At 30 requests per minute, a 500-CV migration takes roughly 17 minutes of steady requests. Two things make that reliable:

1. 1

   Pace deliberately, do not burst

   Sending two requests per second and staying under the limit is faster overall than bursting, hitting 429, and backing off.

2. 2

   Make the job resumable

   Track which CVs succeeded. A batch that fails at item 400 should restart at 400, not at 1 — reprocessing costs credits.

3. 3

   Ask for a higher limit first

   If you have a one-off migration, email support@remakecv.com. Raising the limit for the duration is easier than engineering around it — and it is not something you can change yourself, even as an administrator.

#Related

• Errors and status codes — the full error contract
• POST /cvs/process — the endpoint you will call most
• Process a CV and save the result — a paced batch example

#Does a rate-limited request cost a credit?

No. A 429 is rejected before any processing happens.