---
title: "findCaseGroupsByPartyId"
method: GET
path: "/casegroups/partyid/{partyId}"
tags: ["case-group-endpoint"]
---

# findCaseGroupsByPartyId

`GET /casegroups/partyid/{partyId}`

## Request

- Base URL: `https://localhost:8171`
- URL: `https://localhost:8171/casegroups/partyid/{partyId}`
- Auth: none declared

returns a list of case groups with the given party ID

## Path parameters

- `partyId` string, required

## Response `200`

OK

- CaseGroupDTO[]
  - `caseGroupStatus` 'NOTSTARTED' | 'INPROGRESS' | 'COMPLETE' | 'COMPLETEDBYPHONE' | 'REOPENED' | 'NOLONGERREQUIRED' | 'REFUSAL' | 'OTHERNONRESPONSE' | 'UNKNOWNELIGIBILITY' | 'NOTELIGIBLE'
  - `collectionExerciseId` string
  - `id` string
  - `partyId` string
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `surveyId` string

## Other responses

- `204`: No Content if there is no associated casegroup
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/office-of-national-statistics/apis/case-service-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/revisions/6523753b5522?raw)