---
title: "Get Trending Clients"
method: GET
path: "/v1/clients/trending"
tags: ["clients"]
---

# Get Trending Clients

`GET /v1/clients/trending`

## Query parameters

- `direction` 'improving' | 'declining' | 'stable'
- `limit` integer
- `include_archived` boolean
- `portfolio_id` string, nullable — Scope results to a portfolio. Pass an id from GET /portfolios; omit it (or pass 'all-clients') for no scoping. An unknown, malformed or inaccessible id returns 404 rather than all clients. The camelCase spelling 'portfolioId' is accepted as an alias.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-31** `88246c119184` — 1 info
  - added the new optional `query` request parameter `portfolio_id`

[Change history](https://skmtc.dev/knownwell/apis/knownwell-api/changes/v1/clients/trending/get.md)

---

[API](https://skmtc.dev/knownwell/apis/knownwell-api.md) · [All operations](https://skmtc.dev/knownwell/apis/knownwell-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/knownwell/knownwell-api/revisions/88246c119184/schema)