---
title: "Get Clients By Risk"
method: GET
path: "/v1/clients/by-risk/{risk_level}"
tags: ["clients"]
---

# Get Clients By Risk

`GET /v1/clients/by-risk/{risk_level}`

## Request

- Base URL: `https://api.knownwell.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.knownwell.com/v1/clients/by-risk/{risk_level}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/knownwell/apis/knownwell-api/docs/v1/clients/by-risk/:risk_level/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `risk_level` 'high_risk' | 'medium_risk' | 'low_risk' | 'on_track', required

## Query parameters

- `include_archived` boolean
- `limit` integer
- `offset` integer
- `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`

[Operation history](https://skmtc.dev/knownwell/apis/knownwell-api/changes/v1/clients/by-risk/:risk_level/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.dev/knownwell/apis/knownwell-api/revisions/88246c119184?raw)