---
title: "findCollectionExercisesByPartyId"
method: GET
path: "/casegroups/party/{partyId}/collectionexercises"
tags: ["case-group-endpoint"]
---

# findCollectionExercisesByPartyId

`GET /casegroups/party/{partyId}/collectionexercises`

## Request

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

returns collection exercises and associated case group statuses for a given party. Can be filtered by survey_id or restricted to the latest collection exercise per survey using survey_latest.

## Path parameters

- `partyId` string, required

## Query parameters

- `survey_id` string
- `survey_latest` boolean

## Response `200`

OK

- CollectionExerciseCaseGroupDTO[]
  - `collectionExercise` CollectionExerciseDTO
    - `id` string, uuid
    - `surveyId` string
    - `name` string
    - `actualExecutionDateTime` string, date-time
    - `scheduledExecutionDateTime` string, date-time
    - `scheduledStartDateTime` string, date-time
    - `actualPublishDateTime` string, date-time
    - `periodStartDateTime` string, date-time
    - `periodEndDateTime` string, date-time
    - `scheduledReturnDateTime` string, date-time
    - `scheduledEndDateTime` string, date-time
    - `executedBy` string
    - `state` 'CREATED' | 'SCHEDULED' | 'READY_FOR_REVIEW' | 'READY_FOR_LIVE' | 'EXECUTION_STARTED' | 'EXECUTED' | 'VALIDATED' | 'FAILEDVALIDATION' | 'LIVE' | 'ENDED'
    - `exerciseRef` string
    - `userDescription` string
    - `created` string, date-time
    - `updated` string, date-time
    - `deleted` boolean
  - `caseGroupStatus` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-14** `6523753b5522`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/case-service-api/changes/casegroups/party/:partyId/collectionexercises/get.md)

---

[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)