Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll collectionsGETRetrieve a collectionGETEvents in a collection
Changelog
Sign inGet API key

API Reference

Rate Limits

API requests are rate limited per credential. Limits vary by organization plan.

Plan limits

API access requires an Elite or Enterprise plan. Limits are per organization.

PlanRate LimitBurst
Elite300 requests/minute100
Enterprise1,000 requests/minute300

Rate limit headers

Every response reports your current rate-limit state, so you can self-throttle before hitting a 429.

RateLimit-LimitRequests available in a burst (your plan's burst capacity).
RateLimit-RemainingRequests remaining right now.
RateLimit-ResetSeconds until the burst refills to its limit.

When you do exceed the limit, the API returns a 429 with a Retry-After header (seconds to wait):

HTTP/1.1 429 Too Many Requests
Retry-After: 12

{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded" } }

Best practices

  • Cache responses when possible
  • Use exponential backoff on 429 responses
  • Batch operations where the API supports it
  • Monitor your usage in the manage portal
PaginationIdempotency