> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bspk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limiting

All API calls are limited to `30` requests every `10` seconds. Once this limit has been reached, calls will return and error with status code `429`. This rate limit is evaluated on a rolling window basis.

API requests are limited to the amount specified in the returned `X-RateLimit-Limit` header (per 10 seconds). Exceeding that limit will cause BSPK to return an `HTTP 429` response. Check the `X-RateLimit-Limit` and `X-RateLimit-Remaining` headers to see how many more requests you are allowed until throttling kicks in.

```console theme={null}
$ curl -I --header "Authorization: Bearer TOKEN" \
https://api.bspk.com/api/extraction/v1/appointments

> HTTP/1.1 200 OK
> Date: Sat, 07 Aug 2021 00:17:40 GMT
> Content-Type: application/json; charset=utf-8
> X-Ratelimit-Limit: 30
> X-Ratelimit-Remaining: 29
```

Whenever the rate limit is reached, in addition to the other headers you will also receive the `X-RateLimit-Reset` which you can use to smartly call our API again only after rate limit window is reseted.

| key             | eg. value  | Description                                                            |
| :-------------- | :--------- | ---------------------------------------------------------------------- |
| RateLimit-Reset | 1628304730 | The remaining window before the rate limit resets in UTC epoch seconds |

You can use your desired programing language to convert the UTC epoch seconds to DateTime so that you can use it.