---
title: "Get Your Senders"
method: GET
path: "/v1/senders"
tags: ["Senders"]
---

# Get Your Senders

`GET /v1/senders`

## Query parameters

- `page_size` string — Default value is 10, can be at maximum 1000
- `page_token` string — Found in pagination links and can be used to get 'previous' or 'next' items
- `filter[channel]` 'SMS' | 'VIBER' | 'WHATSAPP' — Filter by Channel. Enumeration values [SMS, VIBER, WHATSAPP]
- `filter[status]` 'Pending' | 'Available' | 'Rejected' | 'Canceled' — Filter Senders by Status. Enumeration values [Pending, Available, Rejected, Canceled]
- `filter[type]` EnumSMSSenderTypes[] — Filter SMS Senders by Types. Enumeration values [Local, Mobile, Toll-free, Alphanumeric, Short-code]
- `filter[name]` string — Filter Senders by Name

## Response `200`

OK

- SenderResponseListWrapperDto
  - `data` SenderResponseDto[]
    - `id` string, uuid — Unique identifier of the sender
    - `account_id` string, uuid — Unique identifier of the account
    - `name` string — Name (unique identifier) of the sender
    - `code` string — User's company or brand name used as a sender identifier. Possible values: did - up to 15 digits string, consisting of numbers only, short code - from 5 to 6 digits string consisting of numbers only, alphanumeric - up to 11 digits string, combination of alphabetical and numerical characters
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP' — Channel for which the sender can be used for. Possible values: [SMS, VIBER, WHATSAPP] Note: Every channel can use only its own senders
    - `type` 'Local' | 'Mobile' | 'Toll-free' | 'Alphanumeric' | 'Short-code' — Type of the sender. Enumeration values [Local, Mobile, Toll-free, Alphanumeric, Short-code]
    - `status` 'Pending' | 'Available' | 'Rejected' | 'Canceled' — Status of the sender. Enumeration values [Pending, Available, Rejected, Canceled]
    - `country` string — ISO country code of the sender
    - `countries` string[]
    - `monthly_cost` string — Monthly cost of the sender
    - `setup_cost` string — Setup cost of the number
    - `create_date` string, date-time — Creation date of the sender in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the sender in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `sample_message` unknown
  - `pagination` Pagination
    - `number` integer — Current page number
    - `size` integer — Page size. Default value is 10, can be at maximum 1000
    - `total` integer — Total count of requested resources
    - `links` object — Contains URLs to get next/previous resources
      - `first` string — URL to the first page
      - `current` string — URL to the current page
      - `previous` string — URL to the previous page, if any
      - `next` string — URL to the next page, if any

## Other responses

- `400` — **Bad Request:** Code Message Description 1411 'filter\[channel\]' value should be \[SMS, VIBER, WHATSAPP\] 1414 Invalid number type specified Should be \[Local, Mobile, Toll-free, Alphanumeric, Short-code\] 1439 Invalid status Should be \[Pending, Available, Rejected, Canceled\]

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)