Teachworks · Rate Limits

Teachworks Rate Limits

The Teachworks API publishes a fixed per-token rate limit of 4 requests per second. Rate limiting is scoped to the API token, so all integrations sharing a token share the budget. List endpoints are paginated - 20 records per page by default, configurable with the per_page parameter up to a maximum of 80, and navigated with a 1-based page parameter. The published usage policy also prohibits excessive requests and retrieving records in a continuous loop, and states the API is not intended for bulk backups (use the in-app Excel download feature for that). All requests must be made over HTTPS.

Teachworks Rate Limits is the machine-readable rate-limit profile for Teachworks on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 3 rate-limit definitions, measuring requests and records.

The profile also includes 4 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Education, Tutoring, Rate Limiting, Quotas, and Pagination.

3 Limits Throttle: 429
EducationTutoringRate LimitingQuotasPagination

Limits

Requests Per Token token
requests
4 per second
Documented hard limit; the API is rate limited by API token at 4 requests per second.
Default Page Size request
records
20 per page
List endpoints return 20 records per page by default.
Maximum Page Size request
records
80 per page
The per_page parameter can raise the page size to a maximum of 80 records.

Policies

No Continuous Looping
The usage policy prohibits excessive requests and retrieving records in a continuous loop.
Not For Backups
The API is not intended for backing up records; account backups should use the in-app Excel download feature.
HTTPS Only
All API requests must be made over HTTPS; plain HTTP calls fail.
Backoff Strategy
Clients should honor 429 responses with exponential backoff and stay within the 4 requests/second per-token budget.

Sources