---
title: "Retrieve a subscriber by ID"
method: GET
path: "/subscribers/{subscriberId}"
tags: ["Subscribers"]
---

# Retrieve a subscriber by ID

`GET /subscribers/{subscriberId}`

## 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/{subscriberId}`
- Auth: API key in header `X-API-Key`

Fetches a specific subscriber using its UUID.

## Path parameters

- `subscriberId` string, uuid, required

## Response `200`

Subscriber retrieved.

- Subscriber: Represents subscriber information including fields, tags, and status.
  - `id` string, uuid
  - `values` SubscriberFieldValue[]: Subscriber field display values for the subscriber. Use subscriber field value endpoints for typed values and option IDs.
    - `id` string, uuid
    - `personalizationTagName` string: Stable subscriber personalization tag name returned in the personalizationTagName property.
    - `value` string: Display value for this field. Choice and multi-select values are returned as labels for display; use subscriber field value endpoints for typed option IDs.
  - `tags` string[]: List of tag identifiers associated with the subscriber.
  - `subscriberStatus` 'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED'
  - `registeredAt` string: Registration date/time of the subscriber.
  - `lastImportedAtUtc` string, date-time
  - `gdprAgreement` string: Text of GDPR agreement if applicable.

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