API pagination#

The default page size is 100 results. You can change the page size limit. The maximum permitted size is 250.

When a response contains more than one page, it includes a cursor, which you can use to request the next pages.

For example, say you want to get all active workflows, 150 at a time.

Get the first page:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# For a self-hosted SMS-iT Workflow instance
curl -X 'GET' \
 '<SMS-iT Workflow_HOST>:<SMS-iT Workflow_PORT>/<SMS-iT Workflow_PATH>/api/v<version-number>/workflows?active=true&limit=150' \
 -H 'accept: application/json' \
 -H 'X-SMS-iT Workflow-API-KEY: <your-api-key>' # For SMS-iT Workflow Cloud
curl -X 'GET' \
 '<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150' \
 -H 'accept: application/json' \
 -H 'X-SMS-iT Workflow-API-KEY: <your-api-key>'

The response is in JSON format, and includes a nextCursor value. This is an example response.

1
2
3
4
5
6
7
8
9
{
 "data": [
 // The response contains an object for each workflow
 {
 // Workflow data
 }
 ],
 "nextCursor": "MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA"
}

Then to request the next page:

1
2
3
4
5
6
7
8
9
# For a self-hosted SMS-iT Workflow instance
curl -X 'GET' \
 '<SMS-iT Workflow_HOST>:<SMS-iT Workflow_PORT>/<SMS-iT Workflow_PATH>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
 -H 'accept: application/json' # For SMS-iT Workflow Cloud
curl -X 'GET' \
 '<your-cloud-instance>/api/v<version-number>/workflows?active=true&limit=150&cursor=MTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDA' \
 -H 'accept: application/json'