{"_id":"56c51eec668eb01900719bcd","parentDoc":null,"category":{"_id":"56a96d338791090d00113bab","__v":13,"pages":["56a96d492bb3910d000ee931","56c3cec2106c12170020db96","56c51da4ba4a540d0091b9b7","56c51dc3ba4a540d0091b9b9","56c51eb916c7190d00ff7b19","56c51ec2d7b9ed19008d1752","56c51eec668eb01900719bcd","56c51effba4a540d0091b9bb","56c51f1cf7c4da0d00614b02","56c51f2a8dc1c51900abc142","56c51f367de3580d00bdaf2a","56c67b6270e7660d004a8985","56c67b7cfd00bb0d0016daad"],"project":"564e5930c3553e0d003e53d0","version":"564e5a9b1560880d008d30dc","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-28T01:21:55.716Z","from_sync":false,"order":1,"slug":"patterns","title":"REST API"},"project":"564e5930c3553e0d003e53d0","__v":3,"user":"564e5788230d7c1700c9073e","version":{"_id":"564e5a9b1560880d008d30dc","project":"564e5930c3553e0d003e53d0","__v":22,"createdAt":"2015-11-19T23:26:19.166Z","releaseDate":"2015-11-19T23:26:19.166Z","categories":["564e5a9b1560880d008d30dd","566318e1f5ca460d00f41896","56631d08cd54d50d005015fa","56631d2a81ad7417006a202c","5668ba19fbd7680d009375f4","5668cb8b10bda80d00797ed9","5668cb9d10bda80d00797eda","56830d8a3f94e00d004e2a7a","56830d9072bb720d0091f594","56830d94cb4d190d0027698e","56830dc44aecbd0d00a464c5","569e90f3c9b43e0d00c4bab1","56a96d338791090d00113bab","56b12d8336d2580d00247877","56c36bf0a869d017002ea55b","56c36bf93d30210d00ea84bb","56c77749b935671700ff0304","56c7ab9e5652c217008e091a","56cb8bdad5c6241d00ef5e61","58aefce02470660f00b54539","58aefd0bebd7370f0078b954","59ca65ca4337830026edf24f"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"Foundation","version_clean":"2.0.0","version":"2"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-18T01:31:24.081Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"Sorting refers to having the server sort the results by a field or combination of fields and returning the result set to the client in sorted order. It applies only to [index endpoints](doc:endpoints#resources-index).\n\nThis is especially important when [paginating](doc:pagination), as not all results may be available in the first response.\n\nSorting is specified by the client using a `sort_by` parameter, which uses comma-separated values. Multiple sort values are separated by commas.\nEach sort value consists of a field name that is eligible for sorting and an optional direction specifier. The direction specifier can be `:asc` or `:desc` and is appended to the name of the field. If no direction is specified, an ascending sort is assumed. If multiple values are provided, results will be sorted by the first value, using the second and subsequent values only to break ties with the previous value.\n\nAll [index endpoints](doc:endpoints#resources-index) endpoints have a consistent default sort. Resources will be returned in the same order across requests even if no `sort_by` parameter is specified.","excerpt":"","slug":"sorting","type":"basic","title":"Sorting"}
Sorting refers to having the server sort the results by a field or combination of fields and returning the result set to the client in sorted order. It applies only to [index endpoints](doc:endpoints#resources-index). This is especially important when [paginating](doc:pagination), as not all results may be available in the first response. Sorting is specified by the client using a `sort_by` parameter, which uses comma-separated values. Multiple sort values are separated by commas. Each sort value consists of a field name that is eligible for sorting and an optional direction specifier. The direction specifier can be `:asc` or `:desc` and is appended to the name of the field. If no direction is specified, an ascending sort is assumed. If multiple values are provided, results will be sorted by the first value, using the second and subsequent values only to break ties with the previous value. All [index endpoints](doc:endpoints#resources-index) endpoints have a consistent default sort. Resources will be returned in the same order across requests even if no `sort_by` parameter is specified.