> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Subscriber

> Get a subscriber by email address with notes, lists, sequence enrollments, and recent activity

Retrieve a subscriber by their email address. The response includes the base subscriber profile plus internal notes, list memberships, sequence enrollments, email engagement stats, and the most recent activity events. Open and click stats exclude detected email-security scanners and tracked brand assets by default.

You can also retrieve by external ID with `GET /api/v1/subscribers/external?externalId={externalId}`.

For commerce customers, `customAttributes` include Sequenzy's nightly
[predictive analytics](/concepts/predictive-analytics): `predictedLtv`,
`churnRisk`, `expectedNextOrderAt`, `avgDaysBetweenOrders`, and
`predictionConfidence`.

## Path Parameters

<ParamField path="email" type="string" required>
  Subscriber email (URL encoded)
</ParamField>

## Query Parameters

<ParamField query="externalId" type="string">
  External ID to use with `/subscribers/external`. Use this route for IDs that
  contain `/`.
</ParamField>

<ParamField query="includeMachineEngagement" type="boolean" default="false">
  Set to `true` to include detected scanner, preview, and tracked asset
  open/click events in `emailStats` and recent activity.
</ParamField>

When machine engagement is included, open/click activity events include
`machine`, `engagementQuality`, and `classificationReasons` fields so clients
can distinguish human activity from scanners and tracked assets.

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/subscribers/user%40sequenzy.com" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/subscribers/external?externalId=user_123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "subscriber": {
      "id": "sub_abc123",
      "email": "user@sequenzy.com",
      "externalId": "user_123",
      "firstName": "John",
      "lastName": "Doe",
      "status": "active",
      "emailProvider": "gmail",
      "tags": ["customer", "newsletter"],
      "customAttributes": { "plan": "pro" },
      "notes": [
        {
          "id": "note_123",
          "subscriberId": "sub_abc123",
          "authorId": "user_123",
          "body": "Asked about enterprise pricing",
          "createdAt": "2026-06-28T10:00:00.000Z",
          "updatedAt": "2026-06-28T10:00:00.000Z",
          "author": {
            "id": "user_123",
            "name": "Ana",
            "email": "ana@example.com"
          }
        }
      ],
      "lists": [
        {
          "id": "list_vip",
          "name": "VIP Customers",
          "description": null,
          "isPrivate": false,
          "subscribedAt": "2024-01-10T09:00:00Z",
          "unsubscribedAt": null
        }
      ],
      "sequenceEnrollments": [
        {
          "tokenId": "token_123",
          "sequenceId": "seq_welcome",
          "sequenceName": "Welcome Flow",
          "sequenceStatus": "active",
          "enrollmentStatus": "active",
          "currentNodeId": "node_abc",
          "currentNodeType": "action_email",
          "currentNodeLabel": "Send welcome email",
          "scheduledFor": null,
          "enteredAt": "2024-01-10T09:05:00Z",
          "updatedAt": "2024-01-10T09:05:00Z"
        }
      ],
      "emailStats": {
        "sent": 12,
        "delivered": 12,
        "opened": 9,
        "clicked": 3,
        "bounced": 0,
        "unsubscribed": 0,
        "complained": 0
      },
      "activity": [
        {
          "id": "evt_1",
          "eventType": "custom",
          "eventTime": "2024-01-15T10:25:00Z",
          "emailSendId": null,
          "campaignId": null,
          "clickedUrl": null,
          "machine": false,
          "engagementQuality": "human",
          "classificationReasons": [],
          "bounceType": null,
          "eventName": "saas.purchase",
          "properties": { "plan": "pro" }
        }
      ],
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "externalId is required"
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Subscriber not found"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 500 theme={null}
  {
    "success": false,
    "error": "Internal server error"
  }
  ```
</ResponseExample>