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

# Retrieve a list of Senders

`GET /v2/Channels/Senders`

## Request

- Base URL: `https://messaging.twilio.com`
- URL: `https://messaging.twilio.com/v2/Channels/Senders`
- Auth: HTTP basic

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
    - `pending_display_name` string, nullable: WhatsApp only. The display name the most recent change applies to — awaiting Meta review, approved by Meta and awaiting re-registration, or, once `pending_display_name_status` is `COMPLETED`, the name now in effect (identical to `name`). Absent when no display name change has been made, and once a completed change stops being reported.
    - `pending_display_name_status` 'PENDING_REVIEW' | 'APPROVED' | 'DECLINED' | 'PIN_MISMATCH' | 'REGISTRATION_FAILED' | 'EXPIRED' | 'COMPLETED', nullable: WhatsApp only. The status of the most recent display name change. `PENDING_REVIEW`, `APPROVED` and `DECLINED` are reported by Meta. `PIN_MISMATCH` and `REGISTRATION_FAILED` mean Meta approved the name but it could not be applied; `EXPIRED` means Meta's 14-day window to apply an approved name elapsed. In all three cases, re-submit the same `profile.name` to retry. `COMPLETED` means the name was approved and applied — `name` now returns it. A `COMPLETED` change is reported for 14 days after it completes and is absent afterwards, so treat its presence as "recently completed" rather than a permanent flag; use `pending_display_name_status_date` to tell how recent. Absent when no display name change has been made.
    - `pending_display_name_status_date` string, date-time, nullable: WhatsApp only. The date and time in UTC when `pending_display_name_status` last changed, specified in ISO 8601 format. Absent whenever `pending_display_name_status` is absent, so the three `pending_display_name*` fields are always present or absent together.
    - `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-10-06** (v2) `c5c14a6098a3`: 3 info
  - added the optional property `senders/items/pending_display_name` to the response with the `200` status
  - added the optional property `senders/items/pending_display_name_status` to the response with the `200` status
  - added the optional property `senders/items/pending_display_name_status_date` to the response with the `200` status
- **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`

[Operation 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/6ba17b4505e1?raw)