Skip to main content

​
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.