Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll groupsGETRetrieve a groupGETEvents in a group
Changelog
Sign inGet API key

API Reference

Rate Limits

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

Plan limits

Each organization plan has its own rate limit and burst allowance.

PlanRate LimitBurst
Free (test mode)100 requests/day20
Premium100 requests/minute20
Enterprise1,000 requests/minute50

Rate limit headers

When you exceed the rate limit, the API returns a 429 status code with a

retryAfter
timestamp in the error response body indicating when you can retry.
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retryAfter": 1709234567890
  }
}

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