---
title: "Retrieve subscriber field values by email."
method: GET
path: "/subscribers/by-email/{email}/field-values"
tags: ["Subscriber Field Values"]
---

# Retrieve subscriber field values by email.

`GET /subscribers/by-email/{email}/field-values`

## Request

- Base URL: `https://api.maildroppa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maildroppa.com/subscribers/by-email/{email}/field-values`
- Auth: API key in header `X-API-Key`

Returns typed field values for the subscriber identified by email.

## Path parameters

- `email` string, required

## Response `200`

Subscriber field values retrieved.

- SubscriberFieldValues: Typed subscriber field values for a subscriber.
  - `subscriberId` string, uuid
  - `email` string: Subscriber email address.
  - `subscriberStatus` 'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED'
  - `fields` SubscriberFieldView[]: Subscriber fields with their current typed values.
    - `fieldId` string, uuid
    - `personalizationTagName` string: Stable subscriber personalization tag name.
    - `value` union: Strict typed subscriber field value returned by read endpoints.
      - object: Text subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `text` string, required: Text value.
      - object: Email subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `text` string, required: Email value.
      - object: Number subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `number` number, required: Number value.
      - object: Date subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `date` string, date, required
      - object: Boolean subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `booleanValue` boolean, required: Boolean value.
      - object: Single-option subscriber field value with its display label.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `optionId` string, uuid, required
        - `labels` string[], required: Human-readable selected option label.
      - object: Multi-option subscriber field value with display labels.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `optionIds` string[], required: Selected option IDs.
        - `labels` string[], required: Human-readable selected option labels.

## Other responses

- `401`: Not Authorized
- `403`: Not Allowed
- `404`: Subscriber not found.
- `428`: Accept the customer agreements in the app before using API keys.

---

[API](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta.md) · [All operations](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/revisions/a9f5a3fd1fb0?raw)