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

# Create a survey transfer or share

`POST /pending-surveys`

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