Pagination

Get Started

All top-level Tight API resources support pulling data in bulk by utilizing cursor-based pagination. To get started, simply specify the limit, which is the number of items to return on that page:

curl -X POST https://sandbox.tight.com/v6/banks/transactions/query \
-H 'Authorization: Bearer <access_token>' \
-D '{
        "limit": 100
    }'

The response will contain an array of items up to your specified limit in data and a cursor object:

{
    "result": "SUCCESS",
    "data": [/* list of bank transactions */],
    "error": [],
    "cursor": {
        "after": "eyJBRlRFUiI6ImJ0bl8xNjkifQ==",
        "before": "eyJCRUZPUkUiOiJidG5fMTg2MTAifQ=="
    }
}

Paginate Forward or Backward

Use the cursor.after value to fetch the next page, or cursor.before to fetch the previous page. Include the appropriate cursor value in your next request.

curl -X POST https://sandbox.tight.com/v6/banks/transactions/query \
-H 'Authorization: Bearer <access_token>' \
-D '{
        "limit": 100,
        "cursor": "eyJCRUZPUkUiOiJidG5fMTg2MTAifQ=="
    }'

If the response contains cursor.after: null, you have reached the last page. If cursor.before: null, you are on the first page.

Sort and Jump to a Specific Page

To sort results, add a sorts parameter. To jump to a specific spot, use the start property within sorts.

curl -X POST https://sandbox.tight.com/v6/banks/transactions/query \
-H 'Authorization: Bearer <access_token>' \
-D '{
        "limit": 100,
        "sort": [{
            "orderBy": "description",
            "direction": "ASC",
            "start": "B"
        }],
    }'

Cursor-based pagination is ideal for building user experiences where users can page forward, page backward, sort, and jump to specific pages from any page.

Patterns

Reference

Get Started

Paginate Forward or Backward

Sort and Jump to a Specific Page

​Get Started

​Paginate Forward or Backward

​Sort and Jump to a Specific Page

Get Started

Paginate Forward or Backward

Sort and Jump to a Specific Page