The Stax Bill API is rate-limited under the following default constraints:
For live accounts:
- Maximum of 1,000 requests per minute
- Maximum of 180,000 requests per day
For Sandbox accounts:
- 50 requests per minute
- 5000 requests per day
For TestDrive accounts:
- 10 Requests per minute
- 500 Requests per day
If either one of these maximums has been reached, an HTTP 429 error will be returned.
The body of the error will indicate which limit.
With each call to the API, limit and usage information will be returned in the headers of the response.
| Header | Type | Description |
|---|---|---|
X-Rate-Limit-Limit-Minute | Integer | The maximum number of requests you can make in a given minute |
X-Rate-Limit-Remaining-Minute | Integer | The remaining number of requests you can make for the given minute |
X-Rate-Limit-Reset-Minute | Timestamp | The timestamp indicating when the next minute starts. At this timestamp X-Rate-Limit-Remaining-Minute is set to equal X-Rate-Limit-Limit-Minute |
X-Rate-Limit-Limit-Day | Integer | The maximum number of requests you can make in a given day |
X-Rate-Limit-Remaining-Day | Integer | The remaining number of requests you can make for the given day |
X-Rate-Limit-Reset-Day | Timestamp | The timestamp indicating when the next day starts. At this timestamp X-Rate-Limit-Remaining-Day is set to equal X-Rate-Limit-Limit-Day |