Get a subscriber by ID | listmonk unofficial

1 parameter

idintegerrequired

The integer identifier of the subscriber to retrieve.

1 status code

200Returns the subscriber object, including its identifier, timestamps, UUID, email, name, attributes, status, and lists.

dataobjectoptional

Error handling

The id path parameter must be an integer that identifies an existing subscriber.

import { Client } from "listmonk-unofficial-sdk";

const client = new Client({
  baseUrl: "http://localhost:9000/api",
  auth: {
    username: process.env.API_USER,
    password: process.env.API_PASS,
  },
});

const result = await client.subscribers.get({ id: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21" });

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "example_value",
    "updated_at": "2026-01-15T09:00:00Z",
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "email": "user@example.com",
    "name": "Example Name",
    "status": "active",
    "lists": [
      {
        "subscription_status": "example_value",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Example Name",
        "type": "standard",
        "tags": [
          "example_value"
        ],
        "created_at": "example_value",
        "updated_at": "2026-01-15T09:00:00Z"
      }
    ]
  }
}

Request

Response

Errors