Skip to main content
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. 
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

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.
​
id
string
Unique identifier for the sender account (e.g., sa_01HXYZ).
​
email
string
The email address used as the From address when sending mail.
​
name
string
Human-readable display name shown in the From header (e.g., "Alex Rivera").
​
status
string
Current operational state of the sender account. One of active or paused. Only active accounts can send mail.

​
Example Response

[
  {
    "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 StatusCodeMeaning
400 Bad Requestinvalid_requestThe request was malformed or contained unexpected parameters.
401 Unauthorizedauthentication_failedThe Authorization header is missing, malformed, or the key is invalid.
404 Not Foundworkspace_not_foundNo workspace is associated with the provided API key.