API Rate Limits
project44's APIs are subject to rate limits to ensure the stability, performance, and security of our APIs. A '429' error is returned if a limit is reached. In cases where an endpoint matches multiple of the below categories, the more specific category takes precedence -- an endpoint never falls into more than one rate limit category.
Recommended Best Practices
- Spread out your requests and avoid large bursts.
- Use webhooks to receive data over running GET requests.
It is possible to increase the limits for an organization. This process requires careful evaluation of the specific use case that requires an increased limit. Please work with your project44 contact to determine if an API limit increase is right for your organization.
API
Relevant Endpoints
The endpoints that match more specific paths below are not included in these limits. Each endpoint falls into only one of the categories below.
- /api/**
- /services/**
- /xml/**
- /MercuryGate/**
| Limit | Burst | |
|---|---|---|
| Default per Organization Account | 600 requests/min | 600 requests |
| IP Address | 600 requests/min | 600 requests |
Authentication API
Relevant Endpoints
- /api/v4/oauth2/token
| Limit | Burst | |
|---|---|---|
| Client | 5 requests/min | 50 requests |
| IP Address | 5 requests/min | 50 requests |
Carrier API
Relevant Endpoints
- /api/carriers/**
- /api/v4/capacityproviders/**
| Limit | Burst | |
|---|---|---|
| Default per Organization Account | 600 requests/min | 600 requests |
| IP Address | 600 requests/min | 600 requests |
Image API
Relevant Endpoints
- /api/v2/images/**
- /api/v3/images/**
- /api/v4/images/**
- /api/v4/ltl/images/**
- /api/images/**
- /xml/images/**
| Limit | Burst | |
|---|---|---|
| Default per Organization Account | 200 requests/min (Americas) 60 requests/min (Europe) | 50 requests (Americas) 10 requests (Europe) |
| IP Address | 600 requests/min | 600 requests |
Order API
Relevant Endpoints
- /api/v4/inventory/orders/**
| Limit | Burst | |
|---|---|---|
| Default per Organization Account | 3000 requests/min (Americas) 3000 requests/min (Europe) | 600 requests (Americas) 600 requests (Europe) |
| IP Address | 3000 requests/min | 3000 requests |
Inventory API
Relevant Endpoints
- /api/v4/inventory/items/**
| Limit | Burst | |
|---|---|---|
| Default per Organization | 3000 requests/min (Americas) 3000 requests/min (Europe) | 600 requests (Americas) 600 requests (Europe) |
| IP Address | 3000 requests/min | 3000 requests |