Rate Limits


The Stannp API imposes rate limits to prevent misuse and mitigate potential instability caused by large bursts of incoming traffic.

The majority of our API's allow up to 300 requests per minute. The specific allowances can be seen in the following three response headers which are returned with every request.

  • X-RateLimit-Limit - The total number of requests allowed.
  • X-RateLimit-Remaining - The number of requests remaining for your quota.
  • X-RateLimit-Reset - The time, in seconds for the quota to reset.

In the event of the rate limit being exceeded we will return a http 429 response and the request operation will not be completed. If you are finding that you are running into 429 responses often, please contact us.

Authentication Example
$ curl https://dash.stannp.com/api/v1/users/me \
-u {API_KEY}:
define("API_KEY", "YOUR API KEY");
$opts = array(
    'http' => array(
        'method'  => 'GET',
        'header'  => 'Content-type: application/x-www-form-urlencoded'
    )
);
$context  = stream_context_create($opts);
$result = file_get_contents("https://dash.stannp.com/api/v1/users/me?api_key=" . API_KEY, false, $context);
$response = json_decode($result, true);

print_r($response);
import requests

response = requests.get('https://dash.stannp.com/api/v1/users/me?api_key={API_KEY}')
print(response.text)
var client = new RestClient("https://dash.stannp.com/api/v1/users/me?api_key={API_KEY}");

var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);
Response Headers
{
    "X-RateLimit-Limit":"200",
    "X-RateLimit-Remaining":"158",
    "X-RateLimit-Reset":"46",
    ...,
}