---
title: "Return how many times each person has been picked as a peer reviewer in a review cycle with a peer reviewer cap. Callers without full read access to the review cycle must pass personIds and only get which of those people are full. With formResponseId, anyone who can approve that request gets the counts for its peers, the fewest peers it may have, and whether they can approve past the cap."
method: GET
path: "/v1/org/{orgId}/assessment/{assessmentId}/peer-reviewer-counts"
tags: ["assessment"]
---

# Return how many times each person has been picked as a peer reviewer in a review cycle with a peer reviewer cap. Callers without full read access to the review cycle must pass personIds and only get which of those people are full. With formResponseId, anyone who can approve that request gets the counts for its peers, the fewest peers it may have, and whether they can approve past the cap.

`GET /v1/org/{orgId}/assessment/{assessmentId}/peer-reviewer-counts`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/assessment/{assessmentId}/peer-reviewer-counts`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v1/org/:orgId/assessment/:assessmentId/peer-reviewer-counts/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required
- `assessmentId` string, required

## Query parameters

- `personIds` string
- `formResponseId` string

## Response `200`

successful operation

- PeerReviewerCounts
  - `max` integer: most times one person can be picked; omitted for callers who may not see counts
  - `counts` PeerReviewerCount[]: picks per person; omitted for callers who may not see counts
    - `personId` string, required
    - `count` integer, required
    - `status` 'UNDER' | 'NEAR' | 'AT' | 'OVER', required
  - `fullPersonIds` string[], required: people at or over the cap, who can't be picked
  - `minPicks` integer: fewest peers the request may have when approved; only with formResponseId, omitted when the field has no minimum
  - `canOverride` boolean: whether the caller can approve the request with a peer over the cap; only with formResponseId

## Other responses

- `400`: bad request
- `404`: not found

## Changes

- **2026-11-06** `ea889502b797`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/charthop/apis/charthop-api/changes/v1/org/:orgId/assessment/:assessmentId/peer-reviewer-counts/get.md)

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/9ba478cf5ae1?raw)