---
title: "Get a respondent by email"
method: GET
path: "/respondents/email"
tags: ["respondents"]
---

# Get a respondent by email

`GET /respondents/email`

## Request

- Base URL: `https://localhost:8081`
- URL: `https://localhost:8081/respondents/email`
- Auth: none declared

Get a respondent by email

## Request body

- object
  - `email` string, email: The email of the respondent

## Response `200`

The respondent has been retrieved

- Respondent
  - `created_on` string, date
  - `email_address` string, email
  - `firstName` string
  - `id` string, integer
  - `lastName` string
  - `markForDeletion` boolean
  - `partyId` string, uuid
  - `passwordResetCounter` integer
  - `passwordVerificationToken` string
  - `pendingEmailAddress` string, email
  - `status` 'CREATED' | 'ACTIVE' | 'SUSPENDED'
  - `telephone` string

## Other responses

- `404`: The respondent does not exist

## Changes

- **2025-03-26** `3bb8cc1e75ce`: 1 breaking, 2 warning, 3 info
  - the `id` response's property format changed from `uuid` to `integer` for status `200`
  - removed the optional property `associations` from the response with the `200` status
  - removed the optional property `sampleUnitType` from the response with the `200` status
  - added the optional property `created_on` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/party-service-api/changes/respondents/email/get.md)

---

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