V4 Data Depot > API > Helpers > Sorting

The sorting helpers allow you to control the arrangement of the response data in a prescribed sequence.

Arrange the API responses in the order that you wish to receive it by sending a sort parameter in your requests.

The parameter syntax structure is: ?sort[direction]=field.

The [direction] portion is optional and [asc] is assumed as default if omitted from your request.

For example: ?sort=field is the same as saying ?sort[asc]=field

Get a collection of Attributekeys sorted in alphabetical order by name.

https://api.wps-inc.com/attributekeys?sort[asc]=name

https://api.wps-inc.com/attributekeys?sort=name

Note that both these requests return the same result, sorted in the same way, because [asc] is the default behavior.

Get a collection of Attributekeys sorted in reverse-alphabetical order by name.

https://api.wps-inc.com/attributekeys?sort[desc]=name

Get a collection of Products that are sorted based on it's child Items list_price.

https://api.wps-inc.com/products?include=items&sort[desc]=items.list_price

Include all the Items of a specific Product and sort those Items by list_price in descending order highest to lowest.

https://api.wps-inc.com/products/187138?include=items:sort(list_price)

As with primary collections, if the sort direction is left off, we'll assume you want asc order.

You can also explicitly pass a direction by adding a pipe character (|) between the field and the direction.

https://api.wps-inc.com/products/187138?include=items:sort(list_price|desc)