> For the complete documentation index, see [llms.txt](https://docs.comfortable.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.comfortable.io/apis/rest-api/filters/sorting.md).

# Sorting

Apply sorting for list endpoints like [All Documents](/apis/rest-api/endpoints.md#all-documents) and [Document Collections](/apis/rest-api/endpoints.md#document-collections). Each sorting parameter refers to one field. It is possible to provide a single or multiple sorting parameters.

Possible values for the sorting parameter are:

| **Value**      | **Function**                        |
| -------------- | ----------------------------------- |
| `ASC` or `1`   | Returns the list ordered ascending  |
| `DESC` or `-1` | Returns the list ordered descending |

{% hint style="info" %}
Lists are ordered descending by default.
{% endhint %}

## Sorted query results

<mark style="color:blue;">`GET`</mark> `https://api.cmft.io/v1/<repoName>/<endpoint>?sorting[<fields|meta>.<fieldName>]=<direction>`

#### Path Parameters

| Name     | Type   | Description                                 |
| -------- | ------ | ------------------------------------------- |
| repoName | string | The API identifier of the repository        |
| endpoint | string | The endpoint you'd like to request          |
| sorting  | string | Provide the order direction `ASC` or `DESC` |

#### Headers

| Name          | Type   | Description        |
| ------------- | ------ | ------------------ |
| Authorization | string | Provide an API Key |

{% tabs %}
{% tab title="200 " %}

```javascript
// Response ordered ascending by title
"data": [
    {
      "fields": {
        "title": "Roses are red"
      },
      "meta": {
        "id": "314159265358979323",
        "contentType": "poem",
        "repository": "314159265358979323",
        "revision": 1,
        "tags": [],
        "createdAt": "2018-01-01T00:00:00.000Z",
        "updatedAt": "2018-01-01T00:00:00.000Z"
      }
    },
    {
      "fields": {
        "title": "Violets are blue"
      },
      "meta": {
        "id": "314159265358979323",
        "contentType": "poem",
        "repository": "314159265358979323",
        "revision": 1,
        "tags": [],
        "createdAt": "2018-01-01T00:00:00.000Z",
        "updatedAt": "2018-01-01T00:00:00.000Z"
      }
    }
]
```

{% endtab %}
{% endtabs %}

## Field Types

Sorting can be applied for the following field types:

* `Text`
* `Richtext`
* `Number`
* `Date & Time`
* `Boolean`
* `Location`
* `Select`
* `Color`

## Examples

Find some examples on the query examples page:

{% content-ref url="/pages/-LEUFxUpSqcfapg6AIxr" %}
[Sorting](/apis/rest-api/examples/sorting.md)
{% endcontent-ref %}