{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Rate Limits","type":"basic","slug":"rate-limits","excerpt":"Preventing yourself from overloading our servers","body":"Rate limiting is performed on a per user, per application basis, effectively making it per access token.\n\nCurrently, each access token is limited to 120 requests for a 60 second window, however this may change in the future.\n\nIf you breach the rate limit, you will receive a status code of `429 Too Many Requests`.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Header\",\n    \"h-1\": \"Explanation\",\n    \"0-0\": \"`X-RateLimit-Limit`\",\n    \"0-1\": \"The total number of requests per 60 second window.\",\n    \"1-0\": \"`X-RateLimit-Remaining`\",\n    \"1-1\": \"The number of requests you are allowed to make in the current 60 second window.\",\n    \"2-0\": \"`X-RateLimit-Reset`\",\n    \"2-1\": \"The [Unix timestamp](http://en.wikipedia.org/wiki/Unix_time) for when the next window begins.\"\n  },\n  \"cols\": 2,\n  \"rows\": 3\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Retrying\",\n  \"body\": \"If you are implementing a behavior that retries on errors please make sure that you respect the rate limit by reading the headers above. In particular if the `X-RateLimit-Remaining` is less than or equal to zero you should not make another request until the time specified in `X-RateLimit-Reset`.\\n\\nLIFX reserves the right to disable access for any applications that consistently make requests beyond the allowed rate limit.\"\n}\n[/block]","updates":["579131402a66760e00c76572","5f13238346a04a001a3d66c3"],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"55f28173f9f3991900f38a18","category":{"sync":{"isSync":false,"url":""},"pages":["55f28173f9f3991900f38a17","55f28173f9f3991900f38a18","55f28173f9f3991900f38a19","55f28173f9f3991900f38a1a","55f28173f9f3991900f38a1b","55f28173f9f3991900f38a1c"],"title":"Overview","slug":"overview","order":1,"from_sync":false,"reference":false,"_id":"55f28172f9f3991900f38a15","version":"55f28172f9f3991900f38a13","__v":1,"createdAt":"2015-06-17T04:27:26.544Z","project":"54ebb40d6423300d003672c0"},"githubsync":"","createdAt":"2015-06-17T04:41:35.213Z","project":"54ebb40d6423300d003672c0","user":"557e2561eb75d80d00af3dab","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["55f28172f9f3991900f38a14","55f28172f9f3991900f38a15","55f28172f9f3991900f38a16","55f66acb297b37170058accb","5d229ff5e59b8e003ab3a9da"],"_id":"55f28172f9f3991900f38a13","project":"54ebb40d6423300d003672c0","releaseDate":"2015-09-11T07:23:30.065Z","createdAt":"2015-09-11T07:23:30.065Z","__v":3},"__v":5,"parentDoc":null}

Rate Limits

Preventing yourself from overloading our servers

Rate limiting is performed on a per user, per application basis, effectively making it per access token. Currently, each access token is limited to 120 requests for a 60 second window, however this may change in the future. If you breach the rate limit, you will receive a status code of `429 Too Many Requests`. [block:parameters] { "data": { "h-0": "Header", "h-1": "Explanation", "0-0": "`X-RateLimit-Limit`", "0-1": "The total number of requests per 60 second window.", "1-0": "`X-RateLimit-Remaining`", "1-1": "The number of requests you are allowed to make in the current 60 second window.", "2-0": "`X-RateLimit-Reset`", "2-1": "The [Unix timestamp](http://en.wikipedia.org/wiki/Unix_time) for when the next window begins." }, "cols": 2, "rows": 3 } [/block] [block:callout] { "type": "warning", "title": "Retrying", "body": "If you are implementing a behavior that retries on errors please make sure that you respect the rate limit by reading the headers above. In particular if the `X-RateLimit-Remaining` is less than or equal to zero you should not make another request until the time specified in `X-RateLimit-Reset`.\n\nLIFX reserves the right to disable access for any applications that consistently make requests beyond the allowed rate limit." } [/block]