Rate limits

​

What is enforced today

• RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset on every response, so you can see your allowance without guessing at it
• 429 Too Many Requests with Retry-After once the allowance is spent
• notice before the limit takes effect, and a headroom period for existing integrations

​

Building so a limit never breaks you

• Handle 429 from day one. Respect Retry-After when present; fall back to exponential backoff when it isn’t.
• Back off on 5xx too. The same code path covers a restart or a deploy.
• Page efficiently. pageSize=100 plus filters means fewer round trips — see Pagination.
• Prefer a filter to a poll. Fetching a narrow slice repeatedly beats re-reading a full list.
• Cache what rarely changes — pipelines, statuses, users, custom field definitions.

import time, requests

def get_with_retry(url, headers, params=None, max_attempts=5):
    for attempt in range(max_attempts):
        r = requests.get(url, headers=headers, params=params)
        if r.status_code != 429 and r.status_code < 500:
            return r
        wait = int(r.headers.get("Retry-After", 2 ** attempt))
        time.sleep(wait)
    return r