Getting started
Pagination & rate limits
Pagination
List endpoints return paginated results. Pass page_start_id to fetch the next page along with a page_limit (default 100, max 500). Each response includes a pagination object with the next page_start_id if more pages are available.
Rate limits
The API is rate-limited per access token. By default, you can issue up to 120 requests per minute across most endpoints. Heavier endpoints (activities, screenshots) have lower limits.
| Header | Description |
|---|---|
| X-Rate-Limit-Limit | Total requests permitted per window. |
| X-Rate-Limit-Remaining | Requests remaining in the current window. |
| X-Rate-Limit-Reset | Unix timestamp when the window resets. |
429 Too Many Requests
When the limit is exceeded, the API responds with
429 and a Retry-After header indicating when to retry. Need higher limits?
If your integration needs higher rate limits, email support@hubstaff.com with your use case and we'll take a look.