---
title: "List senders"
method: GET
path: "/senders"
tags: ["Senders"]
---

# List senders

`GET /senders`

## Request

- Base URL: `https://api.textla.com/v1`
- URL: `https://api.textla.com/v1/senders`
- Auth: HTTP bearer

Returns the numbers the authenticated account can send campaigns from. `items` is empty when the account has no numbers. `can_send` marks the numbers Create Campaign accepts.

## Response `200`

OK

- ListSendersOutput
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` Sender[], nullable, required: The account's senders. Empty when the account has no numbers.
    - `can_send` boolean, required: True when the number is enabled and verified: A2P Verified, toll-free ProviderApproved, or an Enterprise short code. Create Campaign rejects any other sender with SenderNotFound or SenderNotVerified.
    - `enabled` boolean, required: Whether the number is enabled on the account.
    - `is_default` boolean, required: True for the account's default number.
    - `phone_number` string, required: The number. Use it as phone_number when creating a campaign.
    - `sender_id` string, nullable, required: Enterprise only. Sender ID added to the start of every message sent from this number.
    - `signature` string, nullable, required: Enterprise only. Signature added to the end of every message sent from this number.
    - `status` 'needs_attention_send_allowed' | 'needs_attention_temporary_hold' | 'processing' | 'processing_send_allowed' | 'rejected' | 'verified', nullable, required: Verification status.
    - `type` 'local' | 'mobile' | 'short_code' | 'toll_free', nullable, required: The kind of number.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `412`: Precondition Failed
- `429`: Too Many Requests
- `500`: Internal Server Error
- `501`: Not Implemented
- `502`: Bad Gateway
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/textla/apis/textla-api.md) - [All operations](https://skmtc.dev/textla/apis/textla-api/llms.txt) - [OpenAPI document](https://skmtc.dev/textla/apis/textla-api/revisions/473f03350bc1?raw)