Logo
Search
API Docs

API Pagination & Rate Limits

Webhook Reliability & Security

API Pagination & Rate Limits

Overview

Sulus's list endpoints support a consistent set of pagination and filtering query parameters, and every account has a concurrency limit that acts as the practical throttle on how many calls can run at once. This page covers both: how to page through large result sets, and where concurrency fits in as the thing to actually watch for in production.


Pagination Query Parameters

List endpoints (List Assistants, List Squads, List Phone Numbers, List Chats, and others) support the following query parameters:

ParameterTypeDescription
limitnumberMaximum number of items to return. Defaults to 100.
createdAtGtdate-timeReturns items where createdAt is greater than the specified value.
createdAtLtdate-timeReturns items where createdAt is less than the specified value.
createdAtGedate-timeReturns items where createdAt is greater than or equal to the specified value.
createdAtLedate-timeReturns items where createdAt is less than or equal to the specified value.

Example: list assistants created after a specific date, limited to 10 results:

GET https://api.sulus.ai/assistant?limit=10&createdAtGt=2024-01-01T00:00:00Z
Authorization: Bearer <your-api-key>

All requests require the Authorization header with a Bearer token from your Sulus Dashboard. Timestamp parameters use ISO 8601 date-time format.


Concurrency Limits: The Practical Throttle

Pagination controls how much of your historical data you pull back at once, but the limit that actually affects live traffic is concurrency — how many calls can be active at the same time.

Every Sulus account includes 10 concurrent call slots by default. When you create a call with POST /call, the response includes a subscriptionLimits object you can check to see how close you are to that limit:

{
  "subscriptionLimits": {
    "concurrencyBlocked": false,
    "concurrencyLimit": 10,
    "remainingConcurrentCalls": 9
  }
}
FieldDescription
concurrencyBlockedtrue if the call could not start because all slots were full
concurrencyLimitTotal concurrent call slots available to your organization
remainingConcurrentCallsHow many slots were open at the time the call was created

You can increase your concurrency limit directly from the dashboard under Settings → Billing → Reserved Concurrency (Call Lines), without contacting support.

For the full picture on default limits, batching strategies for large outbound campaigns, and monitoring usage historically, see the Call Concurrency Limits page — this page only covers the pagination parameters and the concurrency response fields relevant to the API itself.