---
title: "Get pending survey transfers or shares by batch number"
method: GET
path: "/pending-surveys/{batch-no}"
tags: ["misc"]
---

# Get pending survey transfers or shares by batch number

`GET /pending-surveys/{batch-no}`

## Request

- Base URL: `https://localhost:8081`
- URL: `https://localhost:8081/pending-surveys/{batch-no}`
- Auth: none declared

Get pending survey transfers or shares by batch number

## Path parameters

- `batch-no` integer, required

## Response `200`

The pending survey transfers or shares have been retrieved

- PendingSurvey[]
  - `email_address` string, email
  - `business_id` string, uuid
  - `survey_id` string, uuid
  - `shared_by` string, uuid
  - `batch_no` integer
  - `is_transfer` boolean
  - `time_shared` string, date-time

## Other responses

- `404`: The batch number does not exist

---

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