---
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`

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.net/office-of-national-statistics/apis/party-service-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/party-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/party-service-api/revisions/a9abfd072409/schema)