API rate limits

How many calls you can make, and what to do when you hit the limit

Last reviewed

The rate-limit headers

Responses from our APIs tell you where you stand against your limit:

  • X-RateLimit-Limit: how many calls the current window allows.
  • X-RateLimit-Remaining: how many of those calls are left.
  • X-RateLimit-Reset: when the window resets, as a Unix timestamp in seconds.
  • Retry-After: sent with a 429 Too many requests answer. It is the number of seconds to wait before you try again.

Browser apps can read these headers too: our APIs allow them through cross-origin requests.

Backing off on a 429

When you get a 429, stop and wait for the number of seconds in Retry-After before you send the call again. Retrying straight away only uses up more of your limit. Add a little random delay so that many workers do not all retry at the same moment.

import random
import time

import requests


def call_with_backoff(session, url, max_attempts=5):
    """GET url, waiting as the API asks whenever it answers 429."""
    for attempt in range(max_attempts):
        response = session.get(url, timeout=30)
        if response.status_code != 429:
            return response
        # Retry-After is the number of seconds to wait. If it is missing,
        # wait longer after each attempt (1s, 2s, 4s ...) plus a little jitter.
        retry_after = response.headers.get("Retry-After")
        delay = int(retry_after) if retry_after and retry_after.isdigit() else 2 ** attempt
        time.sleep(delay + random.uniform(0, 1))
    return response

The error body of a 429 carries the code RATE_LIMITED; see API errors and request IDs.

Rate limits

The current limits for each API

Limits are counted on a sliding window. When you go over one, the API answers 429 Too Many Requests with a Retry-After header telling you how long to wait.

Consumer API

Every request to /api/v1/portfolio/ext/.

  • Silver: 50 requests per hour
  • Gold: 2,000 requests per hour
  • Platinum: 2,000 requests per hour
  • VIP Concierge: unlimited

Shared by every key you hold, so a new key never adds to it. Plans not listed here have no access to this API. Scopes: portfolio:read, portfolio:write, estate:read, residency:read, documents:read.

Professional API

Every request to /api/v1/pro/ext/.

  • Legal Growth: 2,000 requests per hour
  • Support Services Plus: 2,000 requests per hour
  • Legal Enterprise: unlimited
  • Support Services Enterprise: unlimited
  • Founding Member Legal Growth: 2,000 requests per hour
  • Founding Member Support Services Plus: 2,000 requests per hour

Shared by every key you hold, so a new key never adds to it. Plans not listed here have no access to this API. Scopes: pro:read, pro:clients:read, pro:matters:read, pro:documents:read, pro:billing:read, pro:compliance:read, pro:team:read, pro:practice:read, pro:org:read, pro:wills:write.

Partner will creation

POST /api/v1/pro/ext/wills/ only, on top of the Professional API budget.

  • Legal Growth: 30 requests per hour
  • Legal Enterprise: 300 requests per hour
  • Founding Member Legal Growth: 30 requests per hour

Shared by every key you hold, so a new key never adds to it. Plans not listed here have no access to this API. Scopes: pro:wills:write.

Consumer MCP agent tools

MCP tool calls, counted separately from your REST budget.

  • Silver: 50 requests per hour
  • Gold: 2,000 requests per hour
  • Platinum: 2,000 requests per hour
  • VIP Concierge: unlimited

Shared by every key you hold, so a new key never adds to it. Plans not listed here have no access to this API. Scopes: portfolio:read, estate:read, residency:read.

Professional MCP agent tools

MCP tool calls, counted separately from your REST budget.

  • Legal Growth: 2,000 requests per hour
  • Support Services Plus: 2,000 requests per hour
  • Legal Enterprise: unlimited
  • Support Services Enterprise: unlimited
  • Founding Member Legal Growth: 2,000 requests per hour
  • Founding Member Support Services Plus: 2,000 requests per hour

Shared by every key you hold, so a new key never adds to it. Plans not listed here have no access to this API. Scopes: pro:read, pro:clients:read, pro:matters:read, pro:documents:read, pro:billing:read, pro:compliance:read, pro:team:read, pro:practice:read, pro:org:read.

Document downloads

Each vault file or will PDF handed out, on top of the Consumer API budget.

  • Every plan: 60 requests per hour

Shared by every key you hold, so a new key never adds to it. Scopes: documents:read.

Matter briefs and will documents

GET /api/v1/pro/ext/matters/{id}/brief/, GET /api/v1/pro/ext/wills/{id}/document/ and one-off brief bundles, sharing one budget, on top of the Professional API budget.

  • Every plan: 30 requests per hour

Shared by every key you hold, so a new key never adds to it. Scopes: pro:read.

Corporate reporting API

Every request to /api/v1/corporate/ext/.

  • Every plan: 120 requests per minute

Counted separately for each key. Scopes: corporate:reporting:read, corporate:roster:read.

These figures come from the limits the API enforces, also served as JSON at /api/v1/portfolio/rate-limits/.

For the endpoints of each API, open its reference from Which API is for me?

Can’t find what you’re looking for?

Our support team is here to help. Contact us and we’ll get back to you as soon as possible.

Contact us

We use cookies to improve your experience. See our Cookie policy (opens in a new tab) for details.