> ## Documentation Index
> Fetch the complete documentation index at: https://help.skillsdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sorting

> sort=-field,field with per-endpoint whitelists

<Info>
  **Quick Summary:** Sort with `sort=field` (ascending) or `sort=-field` (descending), comma-separated for multiple keys. Sortable fields are whitelisted per endpoint.
</Info>

```bash theme={null}
curl "https://prod.skillsdbnext.com/api/v1/careers?sort=name" \
  -H "Authorization: Bearer sdb_live_YOUR_KEY_HERE"
```

A field outside the endpoint whitelist returns a 400 with code `not_sortable`. Endpoints with a natural order (a career's levels, sections and skills follow their configured positions; the activity feed is newest-first) ignore `sort` and document that in the reference.