---
title: "Create a survey transfer or share"
method: POST
path: "/pending-surveys"
tags: ["misc"]
---

# Create a survey transfer or share

`POST /pending-surveys`

## Request

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

Create a survey transfer or share

## Request body

- union
  - SurveyShare
    - `pending_shares` SurveyProperties[]
      - `business_id` string, uuid
      - `survey_id` string, uuid
      - `email_address` string, email
      - `shared_by` string, uuid
  - SurveyTransfer
    - `pending_transfers` SurveyProperties[]
      - `business_id` string, uuid
      - `survey_id` string, uuid
      - `email_address` string, email
      - `shared_by` string, uuid

## Response `201`

The survey transfer or share has been created

## Other responses

- `400`: The request body was missing or invalid, or the share/transfer is already in progress
- `404`: The business or respondent does not exist, or the provided business or respondent IDs weren't UUIDs

---

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