Subscribers

Get subscriber by email

Changed on

Retrieves a subscriber by their email address, including notes, list memberships, sequence enrollments, email stats, and recent activity.

get/subscribers/{email}

Request

  • Base URL
    https://api.sequenzy.com/api/v1
  • URL
    https://api.sequenzy.com/api/v1/subscribers/{email}
  • Auth
    HTTP bearer

Path parameters

emailstring required

URL-encoded email address

Query parameters

includeMachineEngagementboolean

Include detected scanner, preview, and tracked asset open/click events in subscriber email stats and recent activity.

Response

Successful response

successboolean

Example response

{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "user@example.com",
    "externalId": "user_123",
    "firstName": "John",
    "lastName": "Doe",
    "timezone": "America/New_York",
    "phone": "+15551234567",
    "smsStatus": "subscribed",
    "status": "active",
    "unsubscribedAt": "2026-07-15T10:00:00.000Z",
    "emailProvider": "gmail",
    "tags": [
      "premium",
      "newsletter"
    ],
    "customAttributes": {
      "plan": "pro",
      "signupSource": "website"
    },
    "phoneCountry": "US",
    "lists": [
      {
        "id": "list_vip",
        "name": "VIP Customers"
      }
    ],
    "sequenceEnrollments": [
      {
        "tokenId": "token_123",
        "sequenceId": "seq_welcome",
        "sequenceName": "Welcome Flow",
        "sequenceStatus": "active",
        "enrollmentStatus": "active",
        "currentNodeId": "node_abc",
        "currentNodeType": "action_email",
        "currentNodeLabel": "Send welcome email"
      }
    ],
    "notes": [
      {
        "id": "note_123",
        "companyId": "comp_abc123",
        "subscriberId": "sub_abc123",
        "authorId": "user_123",
        "body": "Asked about enterprise pricing",
        "author": {
          "id": "user_123",
          "name": "Ana",
          "email": "ana@example.com"
        }
      }
    ],
    "activity": [
      {
        "eventType": "custom",
        "eventName": "saas.purchase"
      }
    ]
  }
}

Changes

  • db3873ca3d4dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • f1d8cfd9faafRevision changes
    • warning

      added the new undefined enum value to the //// response property for the response status

    • info

      added the optional property ///// to the response with the status

    • info

      removed from the // response property allOf list for the response status

    • info

      added subschema #1 subschema #2 to the // response property anyOf list for the response status