Paginating allows your results to be separated into a discrete number of pages. This is helpful to avoid delays if large amounts of data is being accessed.

Pagination works with the following tables/urls:

API
  • Tickets Table
  • Contacts Table
  • Customer Table URL: .../customers/{id}/tickets/
  • Customer Table URL (for Zapier integration): .../zapier/customers/{id}/tickets/

Customer API
  • Organizations Table
  • Tickets Table URL .../tickets/

The default is no pagination. To use the pagination at least one of the following two parameters must be sent in the URL. If only one is used, the other field will be set with the default value.

  • pageSize: Default value is 50. Specifies the maximum number of results returned per page. If there are not enough results to reach the maximum, then the exact number of results will be returned.
  • pageNumber: Default value is 1. Specifies a specific page to return. For example, if you would like to view the 5th page of results, you would enter the the value “5” for this field.

The results returned will include a TotalRecords element. With this you can figure out how many pages there are based on the pagesize.

Examples:

.../api/xml/tickets?name[contains]=Test&pageNumber=2&pageSize=40

This will return the second page of results. Each page will contain 40 records.
Lets say the TotalRecords is 164. In this case, there will be 5 total pages. Pages 1-4 will have 40 records and page 5 with a remaining 4 records.

.../api/xml/tickets?name[contains]=Test&pageNumber=3

This will return the third page of results. Each page will contain 50 records (default).
Lets say the TotalRecords is 355. In this case, there will be 8 total pages. Pages 1-7 will have 50 records and page 8 with a remaining 5 records.

.../api/xml/tickets?name[contains]=Test&pageSize=10

This will return the first page of results (default). Each page will contain 10 records.
Lets say the TotalRecords is 31. In this case, there will be 4 total pages. Pages 1-3 will have 10 records and page 4 with a remaining 1 record.

Need more help with this?
Customer Support

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.