Skip to content
Lightfield Lightfield
API Reference
Sender

List senders

client.sender.list(SenderListParams { limit, offset } query?, RequestOptionsoptions?): SenderListResponse { data, object, totalCount }
GET/v1/senders

Returns a paginated list of the email and LinkedIn senders that sequences send from, archived ones included, ordered by createdAt descending. Use offset and limit to paginate, and bracketed filters to narrow the list.

Supported filters: channel[equal] (EMAIL, LINKEDIN), health[equal] (UNVERIFIED, HEALTHY, UNHEALTHY), owner[equal] (a member ID), and archived[equal] (true, false). Filters are combined with AND.

Required scope: senders:read

Rate limit category: Search

ParametersExpand Collapse
query: SenderListParams { limit, offset }
limit?: number

Maximum number of records to return. Defaults to 25, maximum 25.

minimum1
maximum9007199254740991
offset?: number

Number of records to skip for pagination. Defaults to 0.

minimum0
maximum9007199254740991
ReturnsExpand Collapse
SenderListResponse { data, object, totalCount }
data: Array<Data>
id: string

Unique identifier of the sender.

archivedAt: string | null

When the sender was archived, or null if it is active. Archived senders never send.

channel: "EMAIL" | "LINKEDIN"

Whether this sender sends email or LinkedIn messages.

One of the following:
"EMAIL"
"LINKEDIN"
createdAt: string

When the sender was created.

emailAddress: string | null

The address email from this sender is sent from. Null for LinkedIn senders, or when the connected account has no address.

health: "UNVERIFIED" | "HEALTHY" | "UNHEALTHY"

HEALTHY can send. UNHEALTHY cannot send until healthReason is resolved. UNVERIFIED means no health verdict yet: an email sender in this state cannot send until it passes a health check, while a LinkedIn sender is never health-checked, so a working LinkedIn sender is usually UNVERIFIED and can send.

One of the following:
"UNVERIFIED"
"HEALTHY"
"UNHEALTHY"
healthReason: string | null

Why the sender is UNHEALTHY or UNVERIFIED, for example ACCOUNT_DISCONNECTED, BOUNCE_THRESHOLD or INVITE_LIMIT; null when healthy.

objectType: "sender"

Always sender.

owner: string | null

Member ID of the person who owns this sender, or null when no workspace membership can be resolved.

pacing: Pacing { EMAIL, LINKEDIN_INVITE, LINKEDIN_MESSAGE }

How this sender paces each step type it sends, keyed by sequence step type: EMAIL for an email sender; LINKEDIN_INVITE and LINKEDIN_MESSAGE for a LinkedIn sender.

EMAIL?: Email { dailyLimit, maxGapSeconds, minGapSeconds }

Email steps. Present only on an email sender.

dailyLimit: number

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
maxGapSeconds: number | null

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
minGapSeconds: number

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
LINKEDIN_INVITE?: LinkedinInvite { dailyLimit, maxGapSeconds, minGapSeconds }

LinkedIn connection requests. Present only on a LinkedIn sender.

dailyLimit: number

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
maxGapSeconds: number | null

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
minGapSeconds: number

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
LINKEDIN_MESSAGE?: LinkedinMessage { dailyLimit, maxGapSeconds, minGapSeconds }

LinkedIn messages. Present only on a LinkedIn sender.

dailyLimit: number

Most sends of this step type in any rolling 24 hours.

minimum-9007199254740991
maximum9007199254740991
maxGapSeconds: number | null

Upper bound of the minimum spacing, in seconds. Before each send, a minimum spacing is drawn at random between minGapSeconds and this value, and the send waits until that long after the previous one. Sends can be further apart, for example outside the send window or once dailyLimit is reached. Null means the minimum spacing is always minGapSeconds.

minimum-9007199254740991
maximum9007199254740991
minGapSeconds: number

Lower bound of the minimum spacing between two of its sends, in seconds.

minimum-9007199254740991
maximum9007199254740991
replyToAddress: string | null

SMTP senders only: the connected mailbox replies are sent to and read from. Null for other senders.

transport: "SMTP" | "OAUTH" | null

How an email sender sends: SMTP through its own mail server, OAUTH through its connected Google or Microsoft account. Null for LinkedIn senders.

One of the following:
"SMTP"
"OAUTH"
object: "list"
totalCount: number
minimum-9007199254740991
maximum9007199254740991

List senders

import Lightfield from 'lightfield';

const client = new Lightfield({
  apiKey: 'My API Key',
});

const senderListResponse = await client.sender.list();

console.log(senderListResponse.data);
{
  "data": [
    {
      "id": "id",
      "archivedAt": "archivedAt",
      "channel": "EMAIL",
      "createdAt": "createdAt",
      "emailAddress": "emailAddress",
      "health": "UNVERIFIED",
      "healthReason": "healthReason",
      "objectType": "sender",
      "owner": "owner",
      "pacing": {
        "EMAIL": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        },
        "LINKEDIN_INVITE": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        },
        "LINKEDIN_MESSAGE": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        }
      },
      "replyToAddress": "replyToAddress",
      "transport": "SMTP"
    }
  ],
  "object": "list",
  "totalCount": -9007199254740991
}
Returns Examples
{
  "data": [
    {
      "id": "id",
      "archivedAt": "archivedAt",
      "channel": "EMAIL",
      "createdAt": "createdAt",
      "emailAddress": "emailAddress",
      "health": "UNVERIFIED",
      "healthReason": "healthReason",
      "objectType": "sender",
      "owner": "owner",
      "pacing": {
        "EMAIL": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        },
        "LINKEDIN_INVITE": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        },
        "LINKEDIN_MESSAGE": {
          "dailyLimit": -9007199254740991,
          "maxGapSeconds": -9007199254740991,
          "minGapSeconds": -9007199254740991
        }
      },
      "replyToAddress": "replyToAddress",
      "transport": "SMTP"
    }
  ],
  "object": "list",
  "totalCount": -9007199254740991
}