Pagination

All integrations use the same pagination parameters. But not all integrations support all of the pagination parameters. Please see the Feature Support tab in the integration's page in app.unified.to.

Limit

By default, most list endpoints return a maximum of 100 records per page. You can change the number of records on a per-request basis by passing a limit parameter (in the request URL parameters for REST).

Example: limit=50

However, you can't exceed 100 records per page on most endpoints.

You will know that there aren't any more records, when the number of returned results is less than your requested limit.

Offset

When the response exceeds the requested results, you can paginate through the records by padding a offset parameter that specifies the position of the first result. This parameter is zero-based regardless of integration's paging mechanism.

Filtering with Updated Since

You can filter the list by specifying the minimum updated date updated_gte. This parameter returns lists that have their updated date at of greater than the specific value.

Filtering with Query

You can filter the list by specifying a query parameter. The search will be integration-specific, but will only be used to filter by email or name. eg. query=John query=john@example.com.

If you require additional filtering, you must synchronize your customer's data into your own database where you would then be able to filter on any field.

Unified.to STRONGLY recommends that you synchronize data if you plan on doing queries. It will be much faster, you will be able to query using whatever criteria you want, and the queries will be consistent and not integration-specific. We recommend using our webhooks for synchronization.

Sorting & Ordering

You can sort the results the sort parameter. Valid options include name, updated_at, and created_at. You can order order the results with the order parameter which only has two options: asc and desc.