## List senders

**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](/using-the-api/scopes/):** `senders:read`

**[Rate limit category](/using-the-api/rate-limits/):** Search

### Query Parameters

- `limit: optional number`

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

- `offset: optional number`

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

### Returns

- `SenderListResponse object { data, object, totalCount }`

  - `data: array of object { id, archivedAt, channel, 9 more }`

    - `id: string`

      Unique identifier of the sender.

    - `archivedAt: string`

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

    - `channel: "EMAIL" or "LINKEDIN"`

      Whether this sender sends email or LinkedIn messages.

      - `"EMAIL"`

      - `"LINKEDIN"`

    - `createdAt: string`

      When the sender was created.

    - `emailAddress: string`

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

    - `health: "UNVERIFIED" or "HEALTHY" or "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.

      - `"UNVERIFIED"`

      - `"HEALTHY"`

      - `"UNHEALTHY"`

    - `healthReason: string`

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

    - `objectType: "sender"`

      Always `sender`.

      - `"sender"`

    - `owner: string`

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

    - `pacing: object { 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: optional object { dailyLimit, maxGapSeconds, minGapSeconds }`

        Email steps. Present only on an email sender.

        - `dailyLimit: number`

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

        - `maxGapSeconds: number`

          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`.

        - `minGapSeconds: number`

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

      - `LINKEDIN_INVITE: optional object { 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.

        - `maxGapSeconds: number`

          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`.

        - `minGapSeconds: number`

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

      - `LINKEDIN_MESSAGE: optional object { dailyLimit, maxGapSeconds, minGapSeconds }`

        LinkedIn messages. Present only on a LinkedIn sender.

        - `dailyLimit: number`

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

        - `maxGapSeconds: number`

          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`.

        - `minGapSeconds: number`

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

    - `replyToAddress: string`

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

    - `transport: "SMTP" or "OAUTH"`

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

      - `"SMTP"`

      - `"OAUTH"`

  - `object: "list"`

    - `"list"`

  - `totalCount: number`

### Example

```http
curl https://api.lightfield.app/v1/senders \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY"
```

#### Response

```json
{
  "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
}
```