{"_id":"59778bba32f043002002f5e3","category":{"_id":"59778bb932f043002002f5d4","version":"59778bb932f043002002f5d3","project":"5425e663ffd4411c319a65b4","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-09-26T23:22:58.179Z","from_sync":false,"order":0,"slug":"getting-started","title":"Getting Started"},"project":"5425e663ffd4411c319a65b4","user":"5425e31affd4411c319a65b1","version":{"_id":"59778bb932f043002002f5d3","project":"5425e663ffd4411c319a65b4","__v":1,"createdAt":"2017-07-25T18:19:37.272Z","releaseDate":"2017-07-25T18:19:37.272Z","categories":["59778bb932f043002002f5d4","59778bb932f043002002f5d5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.5.0","version":"2.5"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-09-29T19:00:51.252Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"never","params":[],"url":""},"isReference":false,"order":2,"body":"You may not perform more than **20 requests per second** across all of your organization's API keys. \n\nTo stay within this limit, we strongly recommend that you use a library to help you orchestrate your request rate. It can be very helpful for the rate limiting framework of your choice to be backed by a system like Redis, that way you can ensure that you are staying below the limit across all of your apps that issue requests into Onfleet. You should also favor sequential over parallel requests if you don't want to implement a sophisticated rate limiting system.\n\nIf you exceed 20 req/s, you will first receive a ```429``` error. Failure to slow down your request rate may result in a temporary ban. The headers `X-RateLimit-Limit` and `X-RateLimit-Remaining` are available to help you understand how many requests are available for a given rolling window period and how many are instantaneously remaining for you to make.\n\nShould you require a higher request rate, do let us know by contacting support and we will do everything we can to accommodate your needs. The more details you can share about your existing efforts to stay below the global limit, the better we will be able to understand your situation and provide assistance.","excerpt":"","slug":"throttling","type":"basic","title":"Throttling"}
You may not perform more than **20 requests per second** across all of your organization's API keys. To stay within this limit, we strongly recommend that you use a library to help you orchestrate your request rate. It can be very helpful for the rate limiting framework of your choice to be backed by a system like Redis, that way you can ensure that you are staying below the limit across all of your apps that issue requests into Onfleet. You should also favor sequential over parallel requests if you don't want to implement a sophisticated rate limiting system. If you exceed 20 req/s, you will first receive a ```429``` error. Failure to slow down your request rate may result in a temporary ban. The headers `X-RateLimit-Limit` and `X-RateLimit-Remaining` are available to help you understand how many requests are available for a given rolling window period and how many are instantaneously remaining for you to make. Should you require a higher request rate, do let us know by contacting support and we will do everything we can to accommodate your needs. The more details you can share about your existing efforts to stay below the global limit, the better we will be able to understand your situation and provide assistance.