---
title: "Find persons in the organization, grouped by an expression"
method: GET
path: "/v2/org/{orgId}/person/group-by"
tags: ["person"]
---

# Find persons in the organization, grouped by an expression

`GET /v2/org/{orgId}/person/group-by`

## Path parameters

- `orgId` string, required

## Query parameters

- `scenarioId` string
- `startDate` string, date
- `endDate` string, date
- `q` string
- `columns` string
- `groupBy` string
- `sort` string
- `format` string
- `splitColumns` boolean

## Response `200`

successful operation

- ResultsData
  - `data` object[], required
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]
  - `totalRow` object

## Other responses

- `202` — snapshot currently building
- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/33fc84a173ce/schema)