## Retrieve a sender

`client.Sender.Get(ctx, id) (*SenderRetrieveResponse, error)`

**get** `/v1/senders/{id}`

Retrieves a sender by its ID, archived ones included.

**[Required scope](/using-the-api/scopes/):** `senders:read`

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

### Parameters

- `id string`

  Unique identifier of the sender to retrieve.

### Returns

- `type SenderRetrieveResponse struct{…}`

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

    Whether this sender sends email or LinkedIn messages.

    - `const SenderRetrieveResponseChannelEmail SenderRetrieveResponseChannel = "EMAIL"`

    - `const SenderRetrieveResponseChannelLinkedin SenderRetrieveResponseChannel = "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 SenderRetrieveResponseHealth`

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

    - `const SenderRetrieveResponseHealthUnverified SenderRetrieveResponseHealth = "UNVERIFIED"`

    - `const SenderRetrieveResponseHealthHealthy SenderRetrieveResponseHealth = "HEALTHY"`

    - `const SenderRetrieveResponseHealthUnhealthy SenderRetrieveResponseHealth = "UNHEALTHY"`

  - `HealthReason string`

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

  - `ObjectType SenderRetrieveResponseObjectType`

    Always `sender`.

    - `const SenderRetrieveResponseObjectTypeSender SenderRetrieveResponseObjectType = "sender"`

  - `Owner string`

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

  - `Pacing SenderRetrieveResponsePacing`

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

      Email steps. Present only on an email sender.

      - `DailyLimit int64`

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

      - `MaxGapSeconds int64`

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

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

    - `LinkedinInvite SenderRetrieveResponsePacingLinkedinInvite`

      LinkedIn connection requests. Present only on a LinkedIn sender.

      - `DailyLimit int64`

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

      - `MaxGapSeconds int64`

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

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

    - `LinkedinMessage SenderRetrieveResponsePacingLinkedinMessage`

      LinkedIn messages. Present only on a LinkedIn sender.

      - `DailyLimit int64`

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

      - `MaxGapSeconds int64`

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

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

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

    - `const SenderRetrieveResponseTransportSmtp SenderRetrieveResponseTransport = "SMTP"`

    - `const SenderRetrieveResponseTransportOAuth SenderRetrieveResponseTransport = "OAUTH"`

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/Lightfld/lightfield-go"
  "github.com/Lightfld/lightfield-go/option"
)

func main() {
  client := githubcomlightfldlightfieldgo.NewClient(
    option.WithAPIKey("My API Key"),
  )
  senderRetrieveResponse, err := client.Sender.Get(context.TODO(), "id")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", senderRetrieveResponse.ID)
}
```

#### Response

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