---
title: "Enrol a respondent on a new survey"
method: POST
path: "/respondents/add_survey"
tags: ["respondents"]
---

# Enrol a respondent on a new survey

`POST /respondents/add_survey`

## Request

- Base URL: `https://localhost:8081`
- URL: `https://localhost:8081/respondents/add_survey`
- Auth: none declared

Enrol a respondent on a new survey, creating any necessary associations and enrolments

## Request body

- object
  - `party_id` string, uuid: The UUID of the respondent
  - `enrolment_code` string: The enrolment code for the survey

## Response `200`

The respondent has been enrolled on the survey

## Other responses

- `400`: The request body was missing party_id or enrolment_code, or the enrolment code was inactive
- `500`: The business couldn't be found to associate with

---

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