---
title: "Create a respondent for share/transfer survey"
method: POST
path: "/pending-survey-respondent"
tags: ["respondents"]
---

# Create a respondent for share/transfer survey

`POST /pending-survey-respondent`

## Request

- Base URL: `https://localhost:8081`
- URL: `https://localhost:8081/pending-survey-respondent`
- Auth: none declared

Create a respondent for share/transfer survey and set them to ACTIVE and enrolment to ENABLED

## Request body

- object
  - `emailAddress` string, email: The email address of the respondent
  - `firstName` string: The first name of the respondent
  - `lastName` string: The last name of the respondent
  - `password` string: The password of the respondent
  - `telephone` string: The telephone number of the respondent
  - `batch_no` string: The batch number of the survey share or transfer

## Response `201`

The respondent has been created

- RespondentWithAssociations
  - `id` string, uuid
  - `sampleUnitType` string
  - `pendingEmailAddress` string, email
  - `firstName` string
  - `lastName` string
  - `telephone` string
  - `status` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
  - `markForDeletion` boolean
  - `passwordVerificationToken` string
  - `passwordResetCounter` integer
  - `associations` Association[]
    - `partyId` string, uuid
    - `sampleUnitRef` string, string
    - `businessRespondentStatus` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
    - `enrolments` Enrolment[]
      - `surveyId` string, uuid
      - `enrolmentStatus` 'PENDING' | 'ENABLED' | 'DISABLED' | 'SUSPENDED'

## Other responses

- `400`: There was an error in the request body
- `404`: The batch number does not exist
- `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)