---
title: "get enrolment details"
method: GET
path: "/enrolments/respondent/{party_uuid}"
tags: ["enrolments"]
---

# get enrolment details

`GET /enrolments/respondent/{party_uuid}`

## Request

- Base URL: `https://localhost:8081`
- URL: `https://localhost:8081/enrolments/respondent/{party_uuid}`
- Auth: none declared

returns a list of all enrolments that match given parameters

## Path parameters

- `party_uuid` string, uuid, required

## Response `200`

dict of respondent enrolments and associated business and survey details

- RespondentEnrolments
  - `business_id` unknown
  - `business_name` string
  - `trading_as` string
  - `ru_ref` string
  - `survey_details` object[]
    - `id` unknown
    - `long_name` string
    - `short_name` string
    - `ref` string
    - `enrolment_status` 'PENDING' | 'ENABLED' | 'DISABLED' | 'SUSPENDED'

## Other responses

- `400`: Missing of malformed parameters
- `404`: Respondent doesn't exist

## Changes

- **2025-03-19** `b29eac2ab8f9`: 1 breaking, 6 warning, 4 info
  - the `survey_details` response's property type changed from `object` to `array` for status `200`
  - removed the optional property `business_details` from the response with the `200` status
  - removed the optional property `enrolment_status` from the response with the `200` status
  - removed the optional property `survey_details/id` from the response with the `200` status
  - …7 more
- **2025-01-09** `0d72a16f4620`: 1 breaking, 3 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the optional property `business_details` to the response with the `200` status
  - added the optional property `enrolment_status` to the response with the `200` status
  - added the optional property `survey_details` to the response with the `200` status
- **2024-11-21** `01b03180beb0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/party-service-api/changes/enrolments/respondent/:party_uuid/get.md)

---

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