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 a429 Too many requestsanswer. 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 responseThe 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
