Pagination

All API endpoints that return a list of elements support pagination. For those endpoints a limit URL query parameter is used to specify number of elements per page.

Examples

1 Request
2 $ http GET 'https://api.gettactic.com/organizations?limit=2' 'Authorization: Bearer ACCESS_TOKEN'
3 
4 Response
5 HTTP/1.1 200 OK
6 {
7     "cursor": "orgz_56ce2a2e-0864-411c-a4db-60ca221fd3f4",
8     "elements": [
9         {
10             "id": "orgz_3dafefbf-e3a5-4bf5-9f00-4cc8586a66c5",
11             "name": "Test Org 3"
12         },
13         {
14             "id": "orgz_56ce2a2e-0864-411c-a4db-60ca221fd3f4",
15             "name": "Test Org 2"
16         }
17     ]
18 }

Use the returned cursor to continue pagination by specifying it as cursor_after. If you want to consume all elements, you continue to do so until cursor is null which also means the list is empty:

1 Request
2 $ http GET 'https://api.gettactic.com/organizations?limit=2&cursor_after=orgz_56ce2a2e-0864-411c-a4db-60ca221fd3f4' 'Authorization: Bearer ACCESS_TOKEN'
3 
4 HTTP/1.1 200 OK
5 {
6     "cursor": "orgz_64010772-1522-4c37-83ca-219ae906d843",
7     "elements": [
8         {
9             "id": "orgz_64010772-1522-4c37-83ca-219ae906d843",
10             "name": "Test Org"
11         }
12     ]
13 }