# Feature OP-9798 - Add order by name per hierarchy to projects API

Project: OpenProject
Status: closed
URL: https://community.openproject.org/work_packages/OP-9798

## Planning

| Attribute | Value |
| --- | --- |
| Date | 2022-01-11 – 2022-02-25 |
| Priority | Medium |
| Target versions | 12.1.0 |
| Sprint | 12.1.0 |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

_No work packages_

## Technical Details

| Attribute | Value |
| --- | --- |
| Module |  |
| Feature Flag |  |
| Requires doc change | No |
| Enterprise plan |  |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Found in mobile app version |  |
| Follow-up feedback e-mail |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Developers |  |
| Designer |  |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**Acceptance criteria**

*   a client of the `GET api/v3/projects` end point can choose to order the projects first by hierarchy and name at the same time:
    *   Every level within the hierarchy of projects is ordered by the project name (not the identifier)
    *   The whole descendants of a project are ordered before its siblings (depth-first)
*   Additional sort option is documented
*   Root projects are also correctly sorted