Pagination and sorting

Below are the endpoints that return a list of objects to support pagination and sorting.

Query parameters

When making a GET request, you can specify the following parameters to move between pages and sort the results included in the response.

The below parameters are optional. If not provided, the Soldo Business API will automatically apply a default.

pThe specific page to display (the counter starts from zero).0
sThe number of objects per page (The maximum is 50, but you can contact our business support team if you want to increase it).50
dHow the results are ordered (ASC, DESC) based on the fields specified with the props parameter.N/A
propsThe response fields on which the sorting should be applied. To apply sorting on multiple parameters, set the props parameter in the request multiple times, e.g. props=id&props=statusN/A


The response contains the following fields which can be used to determine the number of pages, their total size and the results included in them.

totalThe total number of objects.
pagesThe total number of pages.
page_sizeThe maximum number of objects per page.
current_pageThe current page (the counter starts from zero).
results_sizeThe total number of objects included in the results array for the current page.
resultsAn array containing the JSON objects of the specific page currently displayed.


# Request to search all Wallets
curl --request GET \
     --url \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {access_token}'
# Snippet of the response containing the list of Wallets
	"total": 168,
	"pages": 4,
	"page_size": 50,
	"current_page": 0,
	"results_size": 50,
	"results": [
			"id": "8a358051-19ba-11e7-b7cf-06f210f068eb",
			"name": "AAA",
			"currency_code": "GBP",
			"available_amount": 1234567.89,
			"blocked_amount": 0.0,
			"primary_user_type": "main",
			"label": "AA",
			"visible": true,
			"creation_time": "2021-09-22T11:22:19Z",
			"last_update": "2022-11-22T20:37:47Z"