API Usage Policy

Updated 3 months ago by Shimon Modi

TruSTAR's REST API lets you submit data and retrieve reports and IOCs from our platform. To ensure quality of service TruSTAR users we have put in place controls for API usage. 

Company API Quota

For companies that have a company level API quote, you can check your API quota through our front end by going here. You quota resets every 24 hours at 12AM UTC. 

Daily API Usage Status


You can also use the API to check your quota. This call will not count towards your daily quota. 

If your quota is insufficient please contact us at support@trustar.co

API Submissions will not count against your API quota

Platform Wide Rate Limit

We currently support throughput of 20 API calls/min per company. An error response of Too Many Requests (429 - see below) is returned if a company exceeds this limit.

Python SDK

Please download our latest SDK as it will gracefully handle any errors returned due to exceeding the API limit. 

Too Many Requests (429)

This error code is returned when the user has exceeded their allotted requests for a given time interval. They can be adjusted to deal with periods of high load.

When this error is returned, the response body will contain a field called waitTime, which represents the number of seconds that the user must wait before making another request.

Sample JSON

{
              "message": "Request limit exceeded for the current time period.  Please wait 4000 milliseconds before making more requests.",
              "waitTime": 4000
          }
          
          

How Did We Do?