> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadterra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/sender-accounts — List All Sender Accounts

> GET /v1/sender-accounts — Returns all sending identities in your workspace. Each account has an ID, email address, display name, and status.

Use this endpoint to retrieve every sending identity connected to your workspace. Each sender account represents a single email address Leadterra uses to dispatch outbound mail on your behalf. You can check a sender's current status before assigning it to a campaign or pool.

```bash theme={null}
GET /v1/sender-accounts
```

## Authorization

All requests must include a Bearer token in the `Authorization` header. You can find your API key in the Leadterra dashboard under **Settings → API Keys**.

## Request Parameters

This endpoint accepts no query parameters, path parameters, or request body.

## Example Request

```bash theme={null}
curl --request GET \
  --url https://app.leadterra.co/v1/sender-accounts \
  --header "Authorization: Bearer sk_live_YOUR_KEY" \
  --header "Content-Type: application/json"
```

## Response Fields

The response is a JSON array. Each element in the array represents one sender account.

<ResponseField name="id" type="string">
  Unique identifier for the sender account (e.g., `sa_01HXYZ`).
</ResponseField>

<ResponseField name="email" type="string">
  The email address used as the `From` address when sending mail.
</ResponseField>

<ResponseField name="name" type="string">
  Human-readable display name shown in the `From` header (e.g., `"Alex Rivera"`).
</ResponseField>

<ResponseField name="status" type="string">
  Current operational state of the sender account. One of `active` or `paused`. Only `active` accounts can send mail.
</ResponseField>

## Example Response

```json theme={null}
[
  {
    "id": "sa_01HXYZ001",
    "email": "alex.rivera@acme.io",
    "name": "Alex Rivera",
    "status": "active"
  },
  {
    "id": "sa_01HXYZ002",
    "email": "morgan.lee@acme.io",
    "name": "Morgan Lee",
    "status": "paused"
  }
]
```

## Error Codes

| HTTP Status        | Code                    | Meaning                                                                  |
| ------------------ | ----------------------- | ------------------------------------------------------------------------ |
| `400 Bad Request`  | `invalid_request`       | The request was malformed or contained unexpected parameters.            |
| `401 Unauthorized` | `authentication_failed` | The `Authorization` header is missing, malformed, or the key is invalid. |
| `404 Not Found`    | `workspace_not_found`   | No workspace is associated with the provided API key.                    |