---
title: "Retrieve a list of Senders"
method: GET
path: "/v2/Channels/Senders"
tags: ["MessagingV2ChannelsSender"]
---

# Retrieve a list of Senders

`GET /v2/Channels/Senders`

Retrieve a list of Senders for an account.

## Query parameters

- `Channel` string, required — The messaging channel for senders. Supported values are `whatsapp` and `rcs`.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `senders` MessagingV2ChannelsSenderResponse[]
    - `sid` string, nullable — The SID of the sender.
    - `status` 'CREATING' | 'ONLINE' | 'OFFLINE' | 'PENDING_VERIFICATION' | 'VERIFYING' | 'ONLINE:UPDATING' | 'TWILIO_REVIEW' | 'DRAFT' | 'STUBBED' — The status of the sender.
    - `sender_id` string, nullable — The ID of the sender in `whatsapp:<E.164_PHONE_NUMBER>` format.
    - `friendly_name` string, nullable — Optional display label for the sender in the Twilio Console.
    - `configuration` MessagingV2ChannelsSenderConfiguration, nullable — The configuration settings for creating a sender.
      - `waba_id` string, nullable — The ID of the WhatsApp Business Account (WABA) to use for this sender.
      - `verification_method` 'sms' | 'voice', nullable — The verification method.
      - `verification_code` string, nullable — The verification code.
      - `voice_application_sid` string, nullable — The SID of the Twilio Voice application.
      - `account_type` 'ISV' | 'ISVSubAccount', nullable — The account type for ISV Account Type Migration. Set to 'ISV' or 'ISVSubAccount' to configure, empty string to clear, or omit to preserve the existing value.
    - `webhook` MessagingV2ChannelsSenderWebhook, nullable — The configuration settings for webhooks.
      - `callback_url` string, nullable — The URL to send the webhook to.
      - `callback_method` 'POST' | 'PUT', nullable — The HTTP method for the webhook.
      - `fallback_url` string, nullable — The URL to send the fallback webhook to.
      - `fallback_method` 'POST' | 'PUT', nullable — The HTTP method for the fallback webhook.
      - `status_callback_url` string, nullable — The URL to send the status callback to.
      - `status_callback_method` string, nullable — The HTTP method for the status callback.
    - `profile` MessagingV2ChannelsSenderProfileGenericResponse, nullable — The profile information for the sender.
      - `name` string, nullable — The name of the sender.
      - `about` string, nullable — The profile about text for the sender.
      - `address` string, nullable — The address of the sender.
      - `description` string, nullable — The description of the sender.
      - `logo_url` string, nullable — The logo URL of the sender.
      - `banner_url` string, nullable — The banner URL of the sender.
      - `privacy_url` string, nullable — The privacy URL of the sender. Must be a publicly accessible HTTP or HTTPS URI associated with the sender.
      - `terms_of_service_url` string, nullable — The terms of service URL of the sender.
      - `accent_color` string, nullable — The color theme of the sender. Must be in hex format and have at least a 4:5:1 contrast ratio against white.
      - `use_case` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP' | 'MULTI_USE', nullable — The messaging use case type for the RCS sender. Allowed values are `PROMOTIONAL`, `TRANSACTIONAL`, `OTP`, `MULTI_USE`. Defaults to `MULTI_USE` if not provided. Cannot be modified after launch.
      - `vertical` string, nullable — The vertical of the sender. Allowed values are: - `Alcohol` - `Automotive` - `Beauty, Spa and Salon` - `Clothing and Apparel` - `Education` - `Entertainment` - `Event Planning and Service` - `Finance and Banking` - `Food and Grocery` - `Hotel and Lodging` - `Matrimony Service` - `Medical and Health` - `Non-profit` - `Online Gambling` - `OTC Drugs` - `Other` - `Physical Gambling` - `Professional Services` - `Public Service` - `Restaurant` - `Shopping and Retail` - `Travel and Transportation`
      - `websites` object[], nullable — The websites of the sender.
        - `website` string
        - `label` string
      - `emails` object[], nullable — The emails of the sender.
        - `email` string
        - `label` string
      - `phone_numbers` object[], nullable — The phone numbers of the sender.
        - `phone_number` string
        - `label` string
    - `properties` MessagingV2ChannelsSenderProperties, nullable — The additional properties for the sender.
      - `quality_rating` string, nullable — The quality rating of the sender.
      - `messaging_limit` string, nullable — The messaging limit of the sender.
    - `offline_reasons` MessagingV2ChannelsSenderOfflineReasonsItems[], nullable — The reasons why the sender is offline.
      - `code` string, nullable — The error code.
      - `message` string, nullable — The error message.
      - `more_info` string, uri, nullable — The URL to get more information about the error.
    - `compliance` MessagingV2RcsComplianceResponse, nullable — The KYC compliance information. This section consists of response to the request launch.
      - `registration_sid` string, required — The default compliance registration SID (e.g., from CR-Google) that applies to all countries unless overridden in the `countries` array.
      - `countries` MessagingV2RcsComplianceCountryResponse[] — A list of country-specific compliance details.
        - `country` string, required — The ISO 3166-1 alpha-2 country code.
        - `registration_sid` string — The default compliance registration SID (e.g., from CR-Google) that applies to all countries unless overridden in the `countries` array.
        - `status` 'ONLINE' | 'OFFLINE' | 'TWILIO_REVIEW' | 'PENDING_VERIFICATION' — The country-level status. Based on the aggregation of the carrier-level status.
        - `carriers` MessagingV2RcsCarrier[]
          - `name` string — The name of the carrier. For example, `Verizon` or `AT&T` for US.
          - `status` 'UNKNOWN' | 'UNLAUNCHED' | 'CARRIER_REVIEW' | 'APPROVED' | 'REJECTED' | 'SUSPENDED' — The carrier-level status.
    - `url` string, uri, nullable — The URL of the resource.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2026-08-11** (v2) `1b0133a1cf72` — 1 info
  - added the optional property `senders/items/friendly_name` to the response with the `200` status
- **2026-05-06** (v2) `6742cbe164c1` — 1 info
  - added the optional property `senders/items/profile/use_case` to the response with the `200` status
- **2026-03-24** (v2) `06dce5b2c19b` — 1 info
  - added the optional property `senders/items/configuration/account_type` to the response with the `200` status
- **2025-10-28** (v2) `99df3f364d3e` — 3 breaking
  - the response property `senders/items/compliance/countries` became optional for the status `200`
  - the response property `senders/items/compliance/countries/items/registration_sid` became optional for the status `200`
  - the response property `senders/items/compliance/countries/items/status` became optional for the status `200`
- **2025-09-18** (v2) `0dee04926496` — 1 warning
  - added the new `STUBBED` enum value to the `senders/items/status` response property for the response status `200`

[Full history](https://skmtc.dev/twilio/apis/twilio-messaging/changes/v2/Channels/Senders/get.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-messaging.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-messaging/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-messaging/revisions/1b0133a1cf72?raw)